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INTRODUCTION 
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fOWSR BASIC* is a faadiy of software products offering a wide range of 
features and capabilities. These products are available in a variety 
of forms including" ROM* s, TM990 boards, and floppy diskettes, in 
addition to the prograasaing features noroally found in BASIC**. POWER 
BASIC offers the user features specifically designed to support 
real-time industrial control applications. Two family members, 
Evaluation Basic (TM990/it50) and Development Basic (TM990/M51 and 
2M990/452> are designed to execute in a TM990/100M or TM990/101M 
microcomputer board environment. The third member of the family is 
Configurable POWER BASIC (TMSW510F), utilizing the higher performance 
FS990 floppy disk-based system with either the 911 or 913 Video 
Display Terminal 'for program development. Programs developed on 
either Evaluation or- Development BASIC are completely upward 
compatable to Configurable POWER BASIC. The FS990 system provides a 
convenient, efficient environment for the preparation of algorithms, 
intended for and configured into, customized POWER 'BASIC ROMs to be 
executed in the TM990 board based application. Figure 1-1 presents 
the FS990 minicomputer environment in which Configurable POWER BASIC 
executes . 




FIGURE 1-1. ..DEVELOPMENT AND CONFIGURATION CYCLE "J "~ 



/- 
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• Trademark of Texas Instruments 

See POWER BASIC RIPERENCE MANUAL ^dPSOS for more information 
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r.2 POWER BASIC 07ER7IEW 

. The POWER BASIC language is easy to use and understand , and 
*^ eliminates the need to use assembly language in uniting an application 

program. The user may enter program statements or commands required 
to examine, debug, or run a program. Each statement or command is 
completed with a carriage return "which terminates and enters the line* 
POWER BASIC automatically advances one line position and waits for 
additional keyboard input. Once the program is finished to the user*s 
satisfaction, the POWER BASIC Configurator may be executed to produce 
a smatller and faster ROM/RAM partitioned POWER BASIC interpreter which 
may be stored in ROM for later insertion in the TM990 board system. 
The POWER BASIC Configurator scans the user's BASIC application 
programj "remembering" via a control file, each of the POWER BASIC 
Statements and Functions used. The user then executes the TX990 LINK 
Editor, using the Configurator -generated Link control file to complete r*^ 
the configuration process. 

1-.3 POWER BASIC FEATURES 

POWER BASIC has many features that make it ideal for use in the 
industrial control environment: 

• 48 bit floating point arithmetic 

• 24 hour time of day clock- 

• elapsed time for 1/25th of a second or greater 

• asynchronous tr^asfer to user -specified statement number on 
user selected interrupts 

e string manipulation capabilities 

• 3 character variables 

• sophisticated editor 

• calls' to assembly language routines directly from POWER BASIC 

• complete FS990 file management from POWER BASIC 

e Configurator minimizes memory requirements of any POWER BASIC 
program 
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The beaefits^the user will 'derive from Configurable POWER BASIC can be 
seen when the configuration process is complete. The resulting 
run- time module is stand-alone. It is customized at the BASIC 
statement and function level with the specified POWER BASIC 
application program, resulting in a faster and much smaller user 
application than with conventional BASIC interpreters. Further, this 
run-time module is appropriately ROM/RAM partitioned for exectution in 
a TM990/100M or TM990/101M microcomputer board system, and can be 
tested thoroughly with the FS990 system through in-circuit emulation 
using the AlffL* Microprocessor Prototyping Lab. 

1-.4 DEVELOPMENT AND CONFIGURATION CICLE 

Figure t-2 depicts the steps involved in POWER BASIC program 
development during the Configuration process. Most programs can be 
completely developed and debugged on the Host POWER BASIC Interpreter 
which executes on the FS990 system. Additional debugging may be 
performed using- Development BASIC in a TM990 board system when 
interface to the specific application is required. The Configurator 
scans the application program and •Remembers" each of the statements 
and functions used in it. It then 1) produces a corresponding Link 
Control file to selectively include, the referenced POWER BASIC 
statement and function routines-, 2) produces the "ROOT module" 
containing the POWER BASIC application program, and 3) produces a 
listing for a hard copy of the Configuration process. The execution 
of the TX9 90 Link Edi-tor using the Link file generated by the 
Configurator produces the. final "customized" Target POWER BASIC 
Interpreter. The resultant Linked Object module may then be 
programmed into EPROM's using the PROM programmer available on the 
development system. 

Note that throughout this manual the term "HOST POWER BASIC 
INTERPRETER" refers to the BASIC Interpreter which executes on the 
FS990 system, while "Target" POWER BASIC Interpreter refers to the 
BASIC Interpreter generated by the configur«.tion process and Linkage 
Editor. Also note tha.t some environment dependent POWER BASIC 
statements and functions operate differently on the Host POWER BASIC 
interpreter than on the Target POWER BASIC Interpreter. These 
environmental differences are documented in the appropriate paragraphs 
of Section III through VII of this manual. 

A full discussion of installation procedures for the Host POWER BASIC 
Interpreter can be found in Section II. Section VIII contains a 
detailed description of the Configurator and the configuration 
process. 
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FIGURE 1-2. CONFIGUHABLS POWEH BASIC ON FS990/?) 
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ns CGmmnom used in this manual 

The following oonventions are used to describe the statements, 
cosmaands, and examples in this manixal: 

;.. Numeric values for- command parameters are decimal unless othenaise 

specified* 

Angle bjBckets (<*?$ indicate essential elements of user^^supported data 
in statements 9 commands , and examples « 

10 LET <variable> s <expression> to <expression> 

Biaces i{}) indicate a choice between two or more possibilities 
(alternative items), one of which must be included. 

j<rariable> 1 
10 ON|<expression>^THEN GOSUB <statement number- list> 

Brackets ([]) enclose optioxml items/ 

10 [let] As4*ATN(1) 

Items in capital letters must be entered exactly as shown. • 

Items in lowercase letters are user-supplied characters. 



1-5 



SECTION II 

LOADING AND EXECUTION OF HOST POWER BASIC INTERPRETER 

AND CONFIGURATOR 



2\ 1 INTRODUCTION 

The Cenfigiarable POWER BASIC package consists of two modular software 
packages shipped en two diskettes. These diskettes contain the HOST 
POWER BASIC INTERPRETER and the POWER BASIC CONFIGURATOR. The modules 
contained on these diskettes differ only in the terminal used for the 
system console. 

The HOST POWER BASIC INTERPRETER provides the capability for extended 
POWER BASIC program development and debug, with full floppy disk and 
file support. 

The POWER BASIC CONFIGURATOR produces the link control file and root 
module that are required to generate the customized POWER BASIC 
interpreter. In addition, the startup module and a library of POWER 
BASIC object modules to be used by the LINK EDITOR are included on 
these diskettes. 

The two diskette disk names and the pathnames of their contents are 
listed as fellows: ". 



DISKETTE NAME 



CONTENTS 



/iS^^c 



CONFIGURABLE POWER BASIC VDT911 



iCBASIC/711 
sC0NFIG/?1 1 
sCBASIC/LIB 
:STARTC/OBJ 



CONFIGURABLE POWER BASIC VDT913 



:CBASIC/V13 

:C0NFIG/Y13 
jCBASIC/LIB 
sSTARTC/OBJ 



To. load and execute either the POWER BASIC or Configurator software, 
the user must provide a version of the TX990 Operating System (release 
2,3 or later). The user then selects the package(s) wfaicli match the 
device type of the system console supported by the operating system. 
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Load the TX990 Operating System that meets the operating system 
requirements as presented in Paragraph 2-. 4 by performing .the 
steps in "Loading the Operating System", (Section II of the TX990 
OPERATING SYSTEM PROGRAMMEB'S GUIDE). • 



2'. Press the exclamation point (!) key on the system console 
keyboard; 






Either of the selected POWER BASIC or Configurator packages may then 
be loaded into the dynamic task area of the user-supplied 
TX990 Operating System. Note that both software packages cannot 
concurrently reside in the dynamic task area since both packages fully 
utilize the remaining task area for user program storage. These 
packages may be installed (loaded) into the dynamic task area and 
executed under control of either 1) the Operator Communications 
Package (OCP), or 2) the Terminal Executive Development System (T2DS). 
The follciwing paragraphs describe the loading procedure for each 
method, the LUNO's required by each package, and the operating system 
support^ required in the user's TX990 Operation System. 

2-. 2 LOADING OF POWER BASIC AND CONPIGDRATOR PACKAGES 

Both POWER BASIC and the Configurator may be loaded and executed using ' 
either the OCP module or the TXDS control program, (whichever is 
supported by the user's TX990 Operating System). When using the OCP 
MODULE, perform the procedures itemized in Paragraph 2.2.1. When 
using the TXDS control program, perform the procedures itemized in 
Paragraph 2.2.2. 

Note that two POWER BASIC packages and two Configurator packages have 
been shipped on the two diskettes. The two software packages differ 
only in the device used for system console: 1) the 911 Video Display 
Terminal, or 2) the 913 Video Display Terminal. The user must 
select and load the soft\rare package whose console matches the system 
console in the TX990 -Operating System being used. The two packages 
are supplied on the diskettes under the pathnames presented in 
Paragraph 2.1. The pathname extensions designate the system console 
device type for these modules (e.g.,/V13 designates the 913 Video ,-— ^ 
Display Te-minal as the console device of that module) . 

2-.2-.1 LOADING USING OCP 
Proceed as follows: 
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S". If OCP is included ia the system, it responds with a period (.) 
preapts • ;;;l 

! 

9 

4. Place the diskette eoataining the selected POWER BASIC (or 
Configurator) object module into the left diskette drive. 

•5. Using OCP»s LP (Load Program) command, load the selected object 
module from the diskette media into memory as follows: 

.LP,DSCjCBASIC/«*« Load fjfom floppy diskette DSC the 

object module file CBASIC/***, 
f^ ' .where »«* is the console device 



(711 or V13). 



similarly 



.LP,DSC:CONFIG/*»» Load ft'om floppy diskette DSC the 

object module file CONFIG/***, 
where »** is the console device 
• . (VII or 713). 

6. Ente* OOP's EX (Execute) command to execute the POWEH BASIC (or 
Configurator) object module and terminate OCP as follows; 

.EX-,10.TE. Executes POWER BASIC (or Configu- 

rator) and terminates OCP. 

f^' 7e -Observe the following printout or display on the system console; 

CONFIGURABLE POWER BASIC RE7 FS.n.m 
•READY 

or similarly, 

POWER BASIC CONFIGURATOR RE7 C.n.m 

APPLICATION SRCEs 

where, 

n s release number 
• m s revision number 
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8. At this point the POWER BASIC (or Confisurator) package will be 
executing and ready for yoir input. 

'2.2.2 LOADING USING THE TXDS CONTROL PROGRAM 
Proceed as follows: 

1°. Load the TX990 Operating System that meets the operating system 
requirements as presented in Paragraph 2,4 by performing the 
steps in "Loading the Operating System" (Section U of the TX990 
OPERATING SISTEM PROGRAMMER'S GUIDE). • 



•2. . .Pf'ess the exclamation point (1) key on the system console 
keyboard. 



^.-^I^SSv 



3. If OCP is included in the system, it responds with a period (.) 
prompts 



If OCP is not included, proceed to step 5, 



4. Execute the TXDS Control Program by responding to the period (.) 
pron^t as follows: 

I 

. EX,16.TE. 



5'. Observe the following printout on display presented on the system 
console: 

TXDS 936215 »» 010/77 2:05 
PROGRAM: 

6. Place the diskette containing the selected POWER BASIC (or 
Configurator) object module into the left diskette drive and 
then enter the pathname of the POWER BASIC (or Configurator) 
object modxile in response to the "PROGRAM;" prompt as follows: 



■'^SSiBSv 



PROGRAM : DSC : CBASIC/*** 



Load and execute the object 
module file CBASIC/»»», 
where ♦•* is the 'console 
device (711 or 713). 
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or similarly, 

PROGRAM-.DSCsCONFIG/*** Lead and execute the object 

module file CONFIG/***, 
^ere *** is the console 
device (VII or 713)- 



7c Depress the carriage return key aad observe that the INPUT: 
prompt is printed out or displayed on the sytsem console* 

NOTE 

The asterisk (*) feature can be used in lieu of 
the carriage retum/NEW LEIE entry to by pass the 
remaining prompts (Input, Output, Options)* 



8e Make a null entry by depressing the carriage return and observe 
that the OUTPUT: prompt is printed out or displayed on the system 
console e 



Make a null 'entry by depressing the carriage return and observe 
that the OPTIONS: prompt is printed out or displayed on the 
system console c 



Make a null entry by depressing the carriage return and the POWER 
BASIC (or Configurator) program loads from diskette and begins 
execution e Observe the following printout or display on the 
system console: 

CONFIGURABLE POWER BASIC RE7 FS.n.m " 

*READY 

or similarly, 

POWER BASIC CONFIGURATOR REV Cen.m ^ 

APPLICATION SRCEs 

where , 

n s the release number 
ffi s the revision number 
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11". 



At this point the POWER BASIC (or Configurator) oaokaia will h. 
executing and ready your input. i5»rai»r; paoicage will be 



Z-.S UJJtO's 



wi"" ".™™°*^°*^ '"'^' numbers (LDHOs) to represent derleas a. 
StSkn^^tf^f '"■^'■' ^° ^ » "^°- ttls "iT converted " t" 

■ ::-^Vtro^%»t:rihVu^rr'i' j=uiF^"-^^^^^^^^ 

configurator) arl^^oSe'dlh" S^ JtnSro/'-'-' '"^ '*^'= '^"> 

S^°islcVtte'??l?3 whi'^h'Se'^to^'^Li'v! ^'^^"'» »= the device: 
me, and listing outpiS.^a^.nrth^'uSIr""^'' "°^ "°*°- 
TOWEB BASIC to ae devlc« ordllkette S^^J "f aligned b; 
POSES BASIC program or *»r'L|'u3l'r1^'|:4"deveS?'' "^ *' '"'^'^ 

Svlce°To„lti''the"ul^J 4=s ^ht'^tti'^ '^"h'?* '» '^^ =^='» ""^^' 
other supported oStputd^foe ^r iL^^ttl me'lf »i^^ ?"*"" '" "' 
and trail POWEH BASIC statemmts! ^""^ '"•* "^ ««utlng the SPOOL 

•oXSIy^^Sf ^ Sres'a-^^Sole'd': ^^ ""^ " "'- " -' 
2-. 4 OPERATING SYSTEM REQUIEEMENTS r^ 

u'?ifre"th^T99ro^=eS?;,%^n,ri^r-;.'°"'«^ 

«ecute, and Perfo^» fife and Jevnei/OTh™"/'^ '" '"'' 
requirements must be soeclflad f™^ It. „ ■ ^''»"'^=" certain 

operating Systems v^lthTe'i^^'e'iqV^nL'I't:'''"""^ ""'': 
be version 2.3 or. later 

provide either OCP or TXDS for pn.gr^ load and e«cution 
o provide full diskette fUe management 
provide fun task support 

° Sne'rali^*'" ' '"* "^ '^^ '^'^^^ during system 
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Optienally, the user's TX990 Operating System may also support a 
line printer and 733 ASH teradnal and cassettes. These devices are 
•' useful with both the POWER BASIC and Configurator packages. 

2". 5 EQ0IPMEHT REQUIREMENTS 

The POWER BASIC and Configurator software packages require the 
following hardware components connected in the standard FS990 
minicomputer configuration j 

" • FS990 with 24K words of RAM 

• Model FD800 dual floppy disk drive 

• Console ta«ininal (911 TOT or 913 TOT) 

The following optional equipment may also be supported: 

• 733 ASR cassettes and printer 

• Model 8l0:iijae printer 

2.6 RECOMMENDED PROCEDURE 

Before the Il-supplied diskettes are used, they should be copied onto 
backup diskette(s) and the masters stored in a safe place. This 
ensures that the master diskettes are available if the backup 
diskette(s) are destroyed. The diskette/disc backup and initialize 
program will 'be used to copy the diskette as outlined below. For 
f^, details on BACKUP, refer to Section X of the Model 990 Computer 

TX990 Operating System Programmer's Guide. 

The recommended procedure is: 

1) - • Use only one backup (or production) diskette when executing 

either the Host POWER BASIC Interpreter or the Configurator. 

2) Select the configurable POWER BASIC diskette whose console 
device matches the system console of the TX990 -Operating 
System being used. 

3) Copy the appropriate master diskette, "Configurable POWER 
BASIC TOT9XX" to the backup diskette. 

4) Copy the TX LINK Editor (modules :TXSLNK/SIS, •:TXLOVM/SIS, 
:TXL07L/SXS) from TXDS LINK EDITOR DISKETTE to the backup 
diskette. 
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NOTE 

POWER bSi? i^J P'^l^^^ioD) diskette win th. 

eentrol ProgSL S eo;^^! "^ '^^ ^^ontlia ^Li ^. ^^ ^^® available 
aPPUcationrae ba^Sn^*? generation oF a S«/. '''^^** ""^"^es and 
t^e following fiils^^^^P ^^^^^tte in its fiLl"?o™^'i^«? f°^^^ SAsI? 

wxxi then contain 
••CBASIC/»*« ^., 

sCONFlG/»»» Object nodules whose eon,«i . 

■ '^f^^^^S Syste^blLg ufed^ ^fS^ "^^^^^^ 
file extension 7li'S\?r^* ^ ^^ ^^« 
5C0NF1G/LIB ..nh. . 

JSTIRTC/OBJ 2"^??* Library and STASrc m«^ , 

by link control file nrJw °°i"^es referenced • 
to,. ille produced br Configura! 

.-moVM/srs ^.3.2 Link Editor and aasno. . .• 

.•TXLOVL/SYS .and associated overlays. 

NOTE 
The Link Edi'i" 
from Which thJ w produces temporary fiio, 

^e be linked %S ®^°«Ptionally- large anBiff f. ^^ec^tion. 
Object LitVa^ ""^^ °^3r need tol^?^°f^°° P^gram is 
(^STlRTC/oijV i^d tH°'?i^ ^••CoS^IgTib^ ^^« Configurator' 
a separate disKl^^® ^ ^^^ Editor (with « it**''* °°^«le 
«sing the coti/H^f; . ^^« Link Edit 2ft? ^ overlays) to 
t^^cr^ry%l!l\'^ f'^^^^^^ ^^^^^ ^«^ a?rL?lrE?i?|r 



2-7 DEBUG CHECKLIST 



X-f the POWEB BASTr « « 

efaeeklist. ^^^i^7 the FS990 sys^m a^ai^l^,* V.^^^^ 2.^.2, 

against the following 

• ^'J^SSO Operating System 

• ««Sle'?i?^°^T,^^Sy-tem console device corr. 
- Load and exeeSta ^ "^®'^* ^oi^i^sponds to 

-e-t^ system operalS'' "^^ ^^^^^ Ce.g., ^cCat) to 
• Check POWER BASIC a«^ n 
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Batches the console device of the selected POWER BASIC and 
Configurator software packages. 

- If the modules were copied to a backup diskette, verify the 
copy, and try loading and executing the master diskette 
object modules. 

• Cheek parameters of TX990 Operating System 

- Verify that the TX990 Operating System meets all 
specifications as required by the POWER BASIC or Configurator 
packages as presented in Paragraph 2.4. 

If the cause of failure cannot be found, remove the diskettes and call 
yojur TI distributor. Before calling, please be reasonably sure that 
the diskettes are at fault and not the TX990 Operating System or 
FS990 computer. 

2.8 POWER BASIC SAMPLE PROGRAM 

Once POWER BASIC has been initialized, the user may immediately enter 
the following sequence of commands and statements- prevented on the 
following page to verify that POWER BASIC is executing correctly. 
Oth«> sample programs which may be entered and executed are provided 
throughout this manual and in Appendix C. 

When POWER BASIC begins execution it displays the following banner 
message. The user then enters the "SIZE" command to display the 
amount of RAM area "free" for user program storage. (The amount of 
free RAM given in the following examples is dependent on system 
configuration and the Operating System being used). 

CQJ^GDRABLE POWER BASIC REV FS. 1.4 
•READY 

PRGMs BYTES 
VARS: BYTES 
FREEj 18850 BYTES 

(SIZE numbers will depend on system configuration) 

The following program may then be entered: 

10 DIM A(4) 

20 $A(0)=''THE NUMBER IS" 

30 INPUT "INPUT NUMBER", N 

40 IF FRA(N)O0 THSI PRINT $A(0);N; :1gOT0 60 

50 GOSUB 100 ! EVEN OR ODD INTEGER 

60 . PRINT ", ITS SQUARE IS";N»N;", AND ' ITS SQUARE ROOT IS"; 

70 • IF N<0 THEN PRINT " UNDEFINED.":: GOTO 30 

80 PRINT SQR(N);"," 

90 GOTO 30 

100 IF INP(N/2)*2=N THEN PRINT $A(0);« EVEN" ;:: RETURN 

110 PRINT $A(0);" ODD"; 

120 RETURN 
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The user oay then display the program size and Ust the prograa as 
follows; . 

SIZE 

PRGM: 282 BYTES 

VARS: 4 BITES 

FREE: 18564 BITES 

LIST 

10 DIM A(4) 

20 $A(0)s''THE NUMBER IS" 

30 INPUT "INPUT NUMBER", N 

40 IF FRA(N)<>0 THEN PRINT $A(0)|N,-:: GOTO 60 

50 GOSUB 100 ! EVEN OR ODD INTEGER 

._6Q PRINT ", ITS SQUARE IS";N»N;", AND ITS SQUARE ROOT IS": 

70 IF N< THEN PRINT " UNDEFINED. " : : GOTO 30 

80 PRINT SQR(N);"." ^-^ 

90 GOTO 30 

100 IF INP(N/2)»2=N THEN PRINT $A(0):" E7EN" ;:: RETURN 
110 PRINT $A(0);" ODD"; 
120 RETURN 

The RUN command will execute this program. The program will request 
numeric user input by prompting with the question mark as follows: 

RUN 
INPUT NUMBER? 1? (carriage return) 

THE NUMBER IS ODD, ITS SQUARE IS 289, ITS SQUARE ROOT IS 4,1231. 
INPUT NUMBER? -6 (carriage return) 

THE NUMBER IS EVEN, ITS SQUARE IS 36, ITS SQUARE ROOT IS UNDEFINED. 
INPUT NUMBER? 2.35 (carriage return) 

^!?^J^ f'^^' ^^^ ^?^^^ ^2 5.5225, ITS SQUARE ROOT IS 1.532971. 
INPUT NUMBER? (escape key) / 

STOP AT 30 

The user may enter the SIZE command to display the program size and 
the variable storage used by the program. 



SIZE 
PR6M 
VARS 
FREE 



282 BITES 
44 BITES 
18524 BITES 



Ji^ I^^'^J-^s ^"^ program" storage area may then be cleared as shown by 
the following sequence: 



NEW 

CONFIGURABLE POWER BASIC REV FS.1.4 

•READI 

SIZE 

PRGMs BITES 
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VAKSs BITES 
FREES 18850 BITES 

The user should refer t© the remainder of this manual for the 
detailed syntax and explanation of the POWER BASIC Language. 
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SECnON III 
GENERAL PH06R1MMING INFORMATION 



3. 1 G^TERAL 



This seetion contains general prograaming information about the fOVER 
BASIC language. General' language features such as syntax, editing 
ceasaiands, and error listings will "be presented. 

3-. 2 BASIC LANGUAGE 

The POWER BASIC language is composed of coaimands and statements. 
Commands are used tfi 'list, edit, save, load, execute, and debug the 
user's BASIC programs on the Host POWER BASIC Interpreter.' No 
commands are supported in a Target (Configured) POWER BASIC 
Interpreter. Commands begin with the conmand name (or the first three 
letters of the command name in most cases) and are executed 
immediately upon entry. Statements in POWER BASIC programs are 
designed to perform a task or solve a problem. Statements begin with 
a line number and may be displayed and modified by using POWER BASIC 
commands. The user may abort the command or statement entered by: 1) 
NOT using the 'carriage return key at the end of the line, but 
backspacing and retyping the line; or 2) striking the ESCAPE key. 

3-. 3 POWER BASIC PROGRAM 

A POWER BASIC program consists of one or more lines, each miiquely 
/«^ identified by a line number in the range to 32,767, and each 

containing at least one POWER BASIC statement of the form; 

<line numbecixJOWER BASIC* statement* 
100 For Is! To 10 

More than one statement may appear on a single line by separating the 
statements with a double colon (r:). 

«ai.ne numbet>cC3tatefflent 1>:: .statement 2>£ ; ... 
fO AslOss BsSss CsO 

A.POWER BASIC statement cannot be continued onto the next statement 
line. All' POWER BASIC statements are terminated (entered) by entry of 
the carriage return key. 

POWER BASIC will generate automatic line number prompts for the user 
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to facilitate simple program statement entry. Auto-line humbering is 
initiated via the NUMBES command as described in skction 17, paragraph 
4% 6, or by use of the line feed key to terminate statement- entry. 

Auto-line numbering using the line feed key is initialized ; to begin at 
statement number 10 and generates an increment value of 10 between 
subsequent statement numbers. 1 

To initiate auto-line numbering using the line feed k4y, the user 
should either s I 

• Enter a line feed character as the first character of the line 
(to which PO\flER BASIC responds with line number 10), or 

♦ Enter the first (starting) statement number and the associated 
statement and terminate the Une with a line feed entry. "^ 

In both cases, the use of a line feed entry at the end of a statement • 
(rather than the more commonly used carriage return) will result in 
line numbers being generated automatically in increments of 10 after 
each statement is terminated (entered). After the first statement has 
been entered via the line feed key, subsequent statemeints may be 
entered via either the line feed or carriage return keys and auto-line 
numbering will continue. To terminate auto-line numbering, enter an 
empty (vacuous) statement line with a carriage return. 

POWES BASIC programs are executed beginning with the lowest numbered 
line and proceeding with the next highest numbered line until directed 
otherwise by a control statement, or until the last statement on the 
last line is executed. An example of a POWEH BASIC program to compute 
the sum of the squares of two numbers is given below. 

10 LET Xs3 

21 LET Is4 '^ 

33 LET ZsX*X+m 
40 PRINT Z 
57 STOP 

The POWER BASIC line number is also used to associate program editing 
activities with a particxilar statement line in the program; 

•J- 4 • SOURCE STATEMENT FORMAT 

3-.V.1 LINE OTMBER FIELD 

The line number field is the first field of any program line and is a 
decimal integer between 1 and 32-, 767, inclusive. This fieild, which 
starts in the first print position, must not contain anV embedded 



3-2 



blaaks and mast be followfed by at least one blank. 
3.^.2 STATEMiaiT FIELD 

The statement field follows the line nimber in a program line and 
contains one or more POWE^ BASIC statements separated by double colons 
itt)c Each statement i$ comprised of a POWER BASIC keyword followed 
by a number of constants and/or variables separated by POWER BASIC 
operators. All keywords pust be entered in upper (^se. 

3.^.3 TAIL REMARK »' 

The tail remark is separated from the statement field by an 
exclamation point (!) and can be used for source statement 
doc'ximentation. All 'characters following the exclamation point are 
treated as a remark and are not executed. Note that no tail remarks 
^ are configured into the final Target POWER BASIC Interpreter to 

conserve user progi^aa storage area in the final application. 

3.^.4 CHARACTER SET 

The character set for POWER BASIC is the upper and lower case alphabet 
A-Z; numbers 0-9; and special characters !"#$$&' ([[3 )*5=-€+; . •?/• 
Non-prljitable control characters may be specified by enclosing the hex 
representation of the character within angle brackets. For instance, 
a form feed, (ctrl)L, is specified by "<0C>»; a bell, (ctrl)G by 
"•^QW' The phrase "(etrl)" indicates the key code generated when the 
user holds down the control key while depressing the key corresponding 
to the character immediately following. 

• 3.4.5 SPECIAL KEYBOARD CHARACTERS 

The Host POWER BASIC Interpreter is designed to communicate, via the 
TX990 Operating System, to either of two terminal devices. The user 
f^- must select and execute the appropriate POWER BASIC module which 

interfaces to the terminal device supported by the TX990 Operating 
System being used. The terminal devices supported by fee two POWER 
BASIC modules are the 911 and 913 Video Display Terminals (TOT's). The 
key codes generated by these terminals differ slightly in their 
representation. Therefore, the POWER BASIC modules each contain a 
translate table to convert these codes to a standard code used by the 
POWER BASIC Package. Table 3-1 lists the keys of the 7DT911 and 
VDT913 terminal devices which correspond to the special functions used 
• by the POWER BASIC package. All other keys on the keyboard retain 
their normal functions. 

• The phrase "(etrl)" indicates that the user holds down the control key 
vdaile depressing the key corresponding to the character immediately 
following. For example.; "(ctrl)H" means depress the "H" key while 
holding down the key marked] "CTRL" or "CTL". The control (or editing) 
characters are not echoed on the terminal, nor are they stored in the 
input buffer. The keys F0,^F1, F2, and F3 correspond to the function 
keys in the top row of the 911 or 913 Vice© Display Terminals. All 
illegal characters are echoed as a bell and otherwise ignored. 
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TABLE 3-V. SPECIAL FUNCTION KEICODES 



SPECIAL 
FUNCTIONS 




911 VDT 


913 VDT 


CAHHIAGE RETUHN (CR; 


-D 


RETURN 
ENTER 
(ctri)" M 


NEW LINE 


LINE FEED (LF) • 


A 


(down arrow) 
«(ctrl)" J 


(down arrow) 


PERCENT ($) 

* » 


2S 


% 


F3 


ESCAPE 


-/B 


UNLABELED 
FUNCTION KEI» 


RESET 


BAC^PACES AND 
REMOVE CHARACTER 


^F 


DEL CHAR 
"(Ctrl)" 


DEL CHAR 


DISPLAY LINE (In) 
FOR EDITING 


S 


In F1 
Ln"(ctrl>" E 


In FO 


BACKSPACE 
CURSOR 


8 


(left arrow) 
"(ctrl>" H 


(left arrow) 


FORWARD SPACE . 
CURSOR 


-7^ 


(right arrow) 
"(Ctrl)" F 


(right arrow) 


DELETE n 
CHARACTERS 


^ 


F3 n 
"(c1rl>" D n 


F2 n 


^SERT n 
BLANKS" 


3 


F2 n 
"(Ctrl)" I n 


F1 n . 


HOffi CURSOR 


(^ 


HOME 


HOME 


CLEAR SCREEN 
AND HCME CURSOR 


3 


UNLABLED KEYPAD** 
KEI 


aEAR 



./^"^V 



,y*^^^ 



* - Unlabeled function key in upper right hand comer of keyboard 

»• - Unlabeled key located in the upper right-hand comer of the keypad 
to the left of the keyboard 
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3% 5 EDIT MODE COMMANDS 

To aid ia pregram writing and debugging, an advanced editor is 
contained in POWER BASIC. The editor uses the special control 
characters of Table 3-1 to perform these special editing features. 
To Biaiatain consistency with -Evaluation and Development POWER BASIC, 
the special function control keys (eg., "(efe'DH") will be used in the 
following eacamples-j however, the additional special characters of the 
911 or 913 TOT'S may be used to perform these editing functions. 

All characters displayed on the terminal device are entered no matter 
where the cursor is located ^en a CARRIAGE, RETURN or LINE FEED key is 
depressed. 

The "(ctrDE" feature allows editing of program lines previously 
entered into a POWER BASIC program. The form is: • 

(statement number) (etrl)E 
100 (etrl)E 

The line will be displayed with the cursor remaining at the end of the 
line. Any editing as described below may then be performed. 

The following examples illustrate the character insertion and deletion 
features of POWER BASIC. The cursor position is designated by an 
underline (__). 

Entering- « 10 (ctrDE" results in; 
10 A(J-1)=SQR(B(1)+B(1-,2))_ 

^' ^®^® t^at the second argument is missing ft'om the first B array. 

Enter nine control H's to backspace to the offending location, 

10 A(J-1)sSQR(B(l2+B(T,2)) 

and follow with (ctri)I2. POWER BASIC will reply with 

10 A(J-1)sSQR(B(1_ )+B(t-,2)) 

after which the second argument can be entered and followed by a 
CARRIAGE RETURN to enter the edited line. If it is discovered later 
that a third argument of the square root'-'is required, instead of 
retyping the line, enter; 

10 (ctrl)E 
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aad the eemputer will respond withi 

10 A(J-1)=SQR (B(1-,1)+B(1-,2))_ 
Then «iter one (ctrDH followed by (c1rl)I7. The computer responds: 

10 A(J-1)sSQH (B(1-,1)+B(1-,2)_ ) 

Enter the desired characters and press the CAERIIGE RETURN or LINE 
FEED key. The CARRIAGE RETURN enters line 10 into the program and 
returns to the keyboard mode, while the LINE FEED enters line 10 and 
prompts with the next sequential line number (line 20). The 
"(ctrDDn" operator is the reverse operation of the "(ctrDln" 
operator.- For example:. 

30 (clrl)E ^ 

will display statement 30; which has an error, 

30 REM CALCULATE SUB TOTATALS_ 
Entering 4 (ctrl)H's yields 

30 REM CALCULATE SUB TOTATALS 
Entering (ctrl>D2 yields 

30 REM CALCULATE SUB T0TJ5LS 

which is the desired result. Complete the editing of this line by 
entering a CARRIAGE RETURN. 

3-. 6. CONSTANTS ^-^^ 

3% 6.1 HEXADECIMAL INTEGER CONSTANTS 

A hexadecimal integer constant is a decimal digit optionally followed 
by one to four hex digits followed by the letter H with no embedded 
blanks. A hex constant cannot begin with the letters A-F. In these 
cases they must begin with a zero. If more than four digits are 
given, only the right-most four digits are actually used. Valid 
combinations are OH to OFFFFH. 

3-. 6. 2 DECIMAL INTEGER CONSTANTS 

A decimal integer constant is any integer between -32768 and 32767 
inclusive. 
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/f&^^s. 



yfflifcSv 



3-. 6. 3 DECIMAL HEAL CONSTANTS 

A decisal real eohstant is a numeric value with a decimal fraction. 
The number can have no more than 11 significant digits in the Host 
KS\iiER BASIC and may not be larger than 10 or have a negative exponent 
less than 10. Real numbers may be expressed simply as a number 
followed by a decimal fraction, or may also have a exponent assumed to 
be a multiplier of 10 to that power. (Ex-. 123-.M is equivalent to 
n234E2; 0^0000123 is the same as 1-.23 E-5>. 

3. 6-. 4 STHING CONSTANTS 

A string constant is a string of characters enclosed within single or 
double quotes. Paired double^ quotes can be used to enclose single 
quotes, and the reverse is also true. (Example: »IHIS IS A STRING', 
"SO'S TEES", 'Demonstrates -"quotes" within a string'. Non-printable 
characters may be included in string constants by enclosing their hex 
equivalent within angle brackets. (See Character Set, Paragraph 
3v^-. 1). Actually, any character, printable or non-printable, may be 
- included in a character constant. If you want both single and double 
quotes in a constant, single quotes could be represented as " 27 " or 
double quotes as •"'22 ". POWER BASIC stores the constant exactly as 
it appears in the code, and interprets numbers between angle brackets 
only ^en printing them, or when reading them from a DATA statement 
(see Paragraphs' 5-. 7 and 5-. 8)-. Angle brackets are NOT interpreted 
during assignment or comparison. Thus, the constant 'DON 27 T' will 
print as DON'T (five characters) but is kept as a string of eight 
characters. If a program requires the compact form for comparisons 
(i.e., looking for a specific combination of charcters in a source 
string) , it is necessary to read the test string from a DATA statement 
or build it through concatenation of the individual characters. 

For example: 

$TST s 'DON' t^ $027H : : $TST s $TST + "T" 

The above will place the desired five character string into the 
variable $TST. The % operator enables the POWER BASIC user to insert 
nonprintable ASCII character codes into string constants. The 7% 
operation inserts the decimal or hexadecimal ASCH code following the 
% symbol into the charaete* string. For additional information refer 
to Section 5% 8.2-. 

Numbers enclosed within angle brackets WILL be interpreted when 
minted. So if it is necessary to prist out the statement "AOB" (A is 
not equal to B), the angle brackets must be considered non-printable 
charaete's and specified as «A<30'«3E>e" (only the left bracket «) is 
non-printable so that "A<3C»B" is valid and will produce the same 
results). 
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3.7 VABIABLES ' 

POWER BASIC supports four types of variables: simple numeric 
variables, numeric array variables, simple string variables, and 
string array variables* The two numeric variable foimats are used 
extensively in ^OWEB BASIC statements and arithmetic operations, while 
the two string variable formats are used extensively f o r- 
string-chaiBcter manipulation and output. Note that if any POWER 
BASIC numeric ^variable is referenced by a BASIC statement or- command 
and the ^r^r labile has not been previously defined, it will result in a 
"UNDEFINED VARIABLE" error; Also note that if any string variable is 
referenced and has not previously been defined, the string variable 
will b$. defined as a null string. A null string contains no 
characters except the null character (byte ^OO.j^g) as the first 
character of the string. ^^ 

3. T.I SIMPLE VARIABLES 

Names for simple numeric variables must begin with a capital letter* 
(A-Z) and may be followed by one or two more capital letters or a 
number in the range 0-127. Names for variables may not be the same as 
POWER BASIC key wonis or the beginnning of the same, i.e., SIN is not 
a valid name nor-is LIS since it is the same as the first three 
characters in the command LIST. 

Examples: 

Valid names:' A, ABC, CAT, AO, A123. 

Invalid names: ABS (function name) , A.B (non-alphanumeric), 
A130 (number out of range), ABl (only 1 letterin letternumber 
combinations) ,12B (first character must be letter), ABCD (too 

long/. y^m^ 

3.7.2 NUMERIC ARRAY VARIABLES 

The same rules given for* formation of simple numeric variable names 
also apply to numeric array variables with the additional 
specification that numeric array variables must appear in a DIM 
statement. The DIM statement must be executed before the first 
reference to the variable from a simple variable of the same name; 
i.e., PRINT A and PRINT ACO) refer to two completely separate 
variables. When keying in a reference to an array variable, either 
parenthesis or square brackets may be used. (Both become square 
brackets internally and are subsequently printed as square brackets.) 

3-7.3 SIMPLE STRING VARIABLES 

Simple string vaziiables follow the same rules given for- simple numeric 



3-8 






variables with the added specification that the reference must be 
preceded by a dollar sign ($). Internally string data is 
stored left-justified and delimited by a null character (a zero byte). 
Characters are normally represented as 8-bit ASCII (normal 7-bit ASCII 
with the 8th bit set to zero). If the 8th bit is set to one, the 
interpreter will treat the character the same-; however, a charact.br 
with the 8th bit on is NOT equal to the same character with the S^h 
bit off! AH strings are terminated by a null character . A simple 
variable in POWER BASIC is composed of 48 bits, or 6 eight-bit byteb. 
ThM, a maximum of five characters should be stored in a simple string 
variable terminated by a null. Longer strings should be stored in 
string arrays (dimensional string variables) as explained below. Any 
.operation which attempts to place more than the maximum number of 
characters in a siring variable will result data immediately following 
the string variable being overwritten. 



3. 7-. 4 STRING AHRAI 



The same rules given for the formation of numeric array variables 
apply to string array variables with the added requirement that the 
name must be preceded by a dollar sign ($). The dollar sign, however, 
is omitted when defining array variables with the DIM statement. If 
the array is multi-dimensional, the data is stored internally with the 
right-most subscript varying most rapidly. ' 

POWER BASIC, with 48-bit variables, stores 6 bytes maximum per array 
element. This is important if you wish to store a series of naaes 
longer than five characters in an array. For example, the array A is 
dimensioned by the statement, DIM A(2-, 1). The names "RHINOCEROS", 
"ELEPHANT", and "GIBAFFE" would be internally stored as: 

$A(0,0) ; RHINOC(EROS) $A(0,1) i EROS 
^^ $A(1-,0) 't ELEPHA(NT) $A(1-,1)-; NT 

$A(2,0) : GIRAFF(E) $A(2-,1) : E 

The data in the second column of the array is also output when 
printing $A(0,0),$A(1,0), or $A(2,0) since a string is delimited by a 
null -character on printing. Since the string in the first column does 
not contain a null, BASIC continues on to the second column or until 
it finds a null, if that null is overwritten by placing something 
else there, unexpected results may occur. For example, by executing 
A(0-, 1) = A(2,0), and then printing $A(0-,0), the result would be 
• "HHINOCGIRAFFELEPHANT''. 

One additional characteristic of string'°array variables is that 
individual bytes in the variable may be referenced by specifying the 
byte in.dex after the subscript. The first byte of a string is 
• referenced by an index value of 1 , and the index limit extends to thel 
last character of the string-. A semicolon is used to delimit the' 
index from the subscript in this case. Example: $A(0,0;4) is "N" — ^ 
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the fourth- letter in RHINOS in the above example, 



3. 7-. 5 VARIABLE STORAGE 



The following paragraphs will explain the internal variable storage 
structure used by POWER BASIC* This will be helpful when accessing 
variables of BASIC from a "CALLed" assembly language sub routine • 



3-T.5-1 NUMBER ARRAI STORAGE 



Arrays of numbers are stored in memory by row, with each element 
occupying 6 bytes • The storage of singly and doubly dimensioned 
arrays are illustrated in the two diagrams below* Larger dimensioned 
arrays are stored in a similar manner.. 






Single dimensioned array -A with 3 elements starting at Hex address 
E800 : 



E800 




S8Q2 


A(0) 


E804 


• 


E806 




E808 


A(1) 


E80A 




E80C 




E80E 


A(2) 


S810 





Doubly dimensioned array B with 3 rows (first subscript) and 2 colunaas 
(second subscript) starting at hex address F200 : 



y(^fc»v 



F200 
F202 
F204 


B(0-,0) 


F206 
F208 
F2QA 


B(0-,1) 


F2QC 
F20E 
F210 


B(1-,0) 


F212 
F214 
F2i6 


B(1-,1)- 


F218 
F21A 
F21C 


B(2,0) 


F21E 
F220 


B(2,1) 



3-10 



As can be seen f^om the examples abeve, the address of an eleaent ia a 
singly disiensiened army is: 

AHRAX BASE + 6 » (SUBSCHIPT) 

eg. Ad) abeve would be: 

E800 + 6 « 1 s E806 

while the address of an element of a doubly dimensioned array element 

isj 

AHfiAI BASE + 6 » (MDLTIPLER*SUBCRIPT1 + SUBSCRlPTa) 

\fhere the multiplier is the maximum value of the second subscript + t. 
For-iastanee, B(t,0) above would be: 

F200 + 6 • (2*1+0) s F20C 



3.7.5.2 STRINGS AND STRING ASRAI STORAGE 

Strings are stored one ASCII chamcter per byte, and are teraiaated 
with a null byte. Reeailing that POWER BASIC variables are 6 bytes in 
length, the examples below show the string, storage format. 



"BYE" stored in string variable $A at Hex address FOOD 



1^ 



JifMIIK 



FOOO 
F002 
F004 



tlgtl 


"Wii — 


"E" 


00 


X 


X 



"BASIC" stored in starting at hex address F020 jg: 



P020 
F022 
F024 



IfgW 


"A" 


WS" 


tijt! 


IIQW 


00 



strings may also be stored in dimensioned string variables, ia which 
ease each element has the same maximum length as a simple variable. 
■ The example below illustrates the storage of a string array $A having 
3 elements and containing the string "POWER BASIC", starting at Hex 
address EAOO jg. 



3-11 



$A(0) 


EAOO 
1IA02 
EA04 
EA06 
EAOd 
EAOA 
EAOC 
EAOE 
EA10 


npn 


"0" " 




"W" 


«£tt 




"R" 


-njjn 


$A(1) 


"B" 


"A" 




»S" 






"C" 


00 


$A(2) 


X 


X 




X 


X 




X 


X 



If the string of the above example were output using the "PRINT" 
statement, the following strings would result. 

"PRINT $A(0), lAd)" Will -result in-: 

POWER BASIC BASIC 

Strings may be empty or- they may have any length up to their declared 
maximum. Care must be taken that strings of lengths larger than 
specified maximum are not placed into simple or dimensioned string 
variables, or other variables may be written over. 



y^ttK 



3.7.6 VARIABLE FORMAT AND ACCURACY 

Any variable may contain an ASCII character- string, a number, or- both. 
Variable contents are completely program context dependent. 
Floating-point quantities in POWER BASIC are represented in 48 bits. 
The first bit in position represents the sign of the number: for 
positive numbers, 1 for- negative numbers. The bits in positions 1-7 
are the characteristic, or exponent, coded in excess-64 notation. The 
remaining bits of the floating-point number; positions 8-47, contain 
the mantissa or fractional portion of the floating-point number. The 
fraction is always recorded as a positive number; negative floating 
point numbers are not represented in complement form. The binary 
point of the flraction is understood to be just before bit position 8. 

A floating-point number is represented by its fraction times a power 
of 16, with its sign attached to the result. ^The exponent indicating 
the power-of 16 by which the fraction is multiplied is coded in the 
characteristic. The characteristic is 64 greater than the exponent. 
Excess-64 notation permits representation of a wide range of 
magnitudes, roughly from 16 -64to 16+63 (or 10 -75 to 10+75 )-. T^e 
48-bit POWER BASIC Interpreter provides approximately 11 digits of 
accuracy. 



j^^^ 
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POWER BASIC Floating-Point Forraat: 




The pattern 



1000000 



characteristic 



10000000 



00000000 



fraction 



00000000 

J 



includes a characteristic of 64 (hex 40) and therefore an exponent of 
0. The fraction is (binary) -.1000...., or 2**^, or decimal O*. 50. 
Therefore, since the sign bit of denotes a positive number, the 
number represented is +0-.5*l6 s 0.50. 
The pattern 



1 



T00Q0O1 



01010100 



00000000 



00000000 



CI 



54 



00 



00 



includes a characteristic of 65 and therefore an exponent of V. The 
fraction is .010101 s 2-2+2-4+2-6. x^e sign bit of 1 denotes a 
negative number, so the quantity represented is "(2""2+2-A,.2'-6) « i6» - 
•-(2420^.2 2) =--(4+1+0.25) s -5-.25. 

Integer quantities in POWEE BASIC are represented in 32 bits, with 
zeros in bit positions through 15 followed by the two's complement 
16-bit integer in bit positions 16 through 31. 



POWER BASIC Integer Fomat: 



00000000 00000000 



two's complement integer 



POWER BASIC will store a numeric quantity as either a floating point 
or integer value, dependent upon the magnitude of the quantity. If 
the number can be represented as a 16-bit two's complement integer, 
it will be stored in integer format; otherwise it will be stored in 
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integer format; otherwise it will be stored in floating-point format. 
Once a value becomes lar^ enough and is converted into s^, floating 
point value, it is never converted back to integer format e^en if the 
number decreases to the two's complement integer range. 

The following example program will demonstrate the internal integer 
and floating point formats used in POWER BASIC. The program requests 
user input by prompting with a question mark(?). The user may then 
enter any numeric value followed by a carriage return. The value will 
be displayed as a 32-bit integer with the first 16 bits zero, or as a 
48-bit floating-point value. 

10 , INPUT A; 

- 20 PRIHT TAB(20) 

30 FOE isl TO 48 
40 IF 1=2 THEN PRINT " "; 

50 IF 1=9 THEN PRINT " "; 

60 PRINT ^"Q" BIT (A, I); 

70 NEXT I 

80 PRINT 

90 GOTO 10 



RUN 
? 1-. 



? 1 

? 1-.5 

? 123456789012 

? (ESC) Key • 

STOP AT 10 



1000001 0001000000000000000000000000000000000000 
0000000 0000000000000000000000010000000000000000 
1000001 0001100000000000000000000000000000000000 
1001010 0001110010111110100110010001101000010100 



3-. 8 OPERATORS AND EXPRESSIONS 

An expression is a list of variables and constants separated by 
operators. There are three types of POWER BASIC operators and 
expressions: arithmetic, logical, and relational. 






3.8-. 1 ARITHMETIC OPERATORS 

The following is a list of the valid arithmetic operators: 



+ 


addition 


-> 


subtraction 


ft 


multiplication 


/ 


division 


A 


exponentiation 


+ 


unaiy plus 


mo 


unary minus 



3-14 



J!9^l\ 



For a given exponentiation when logarithms are used the m^»- 




CONFIGURABLE POWER BASIC 
213 = 7.9999999999 +1 - .00000000001 
2y b?^?a1rto^L^.^J%;^ °P"J?^°^ ^^ presented is Section 3. 

to internal floating point limitations. ^nTJicipated results 

3-. 8. 2 ARITHMETIC EXPRESSIONS 

An arithmetic expression is any valid sequence of numbers variah" 

lll?.%\Tj:T''''r ^""^'^ »^^°"« ^^^^ parTnthlses'u'st 
properly balanced, and no -two numbers or variables can be adi=n. 
and no two binary operators can be adjacent) ^^^' 

For example? 

An expression may consist of a single operand; 



8 
SIN(A) 



A sequence of operands may be combined by arithmetic operators; 



X»I 

A»B-W/Z 



^ic ?p7r^d?" ^' '" "'^"""^"^ ^ parentheses and considered to b< 



(X+Y)/2 

(A+B)*(C-.D) 
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Any expression may be preceded by a plus or minus sign: 

-(A+B) 
•-A+((TAN(-A))»2) 

3. 8'. 3 LOGICAL OPERATORS 

The logical operators do bit wise operations on integers. They 
consist of the following: 

LNOT (unary) 1»s complement of integer 

LAND (binary) Bit wise AND of two integers 

, LGBf (binary) Bit wise OR of two integers . 

LXOR (binary) Bit wise exclusive OR 

3-. 8. 4 LOGICAL EXPRESSIONS 

Logical expressions are similar to arithmetic expressions. They both 
consist of variables, constants, parenthesis, and operators. The 
primary difference being that the operators are different for logical 
expressions. The logical operators perform a bit-wise logical 
operation on the operand(s). 

For example, if A s OAAAAH (hex "AAAA") , and Bs05555H (hex "5555") and 
C s OBBBBH, (hex "BBBB" ) , • then 

LNOT (A) would' equal "5555" 

A LAND B would equal 

A LOR B would equal 'FFFF' 

A LXOR C would equal » 1 1 11 » ^ 

3.8.5 RELATIONAL OPERATORS 

The relational operators are all binary operators that operate on two 
arithmetic expressions. They return values of 1 (TRUE) or (FALSE). 
Relational operators consist of the following: 

s exactly equal 

sa approx equal (plus or minus .0000007) 

< less than 

<= less than or equal to 

> greater than 

>s greater than or equal to 

<> not equal 
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3-. 8. 6 BOOLEAN OPERATORS 

The booleas operators are designed to work on the resultant TRDE or 
. FALSE eonditions set by the relational operators. However, they may 
also operate on variables within the program, in which case a zero 
value is considered False and a non-zero value variable is considered 
to be TPue. The boolean operators return values of 1 (True) or 
(False). 

Boolean operators consist of the following j 

NOT (UNARI) Returns a TRUE value if expression evaluates to 

FALSE (non-zero) J otherwise returns a FALSE value. 

ANB (BINARX) Returns a TRDE value if both expressions evaluate to 

^DE (non-zero); otherwise returns a FALSE value. 

OR (BINARI) Returns a TRDE value if either expression evaluates 

to TRDE (non-zero); otherwise returns a F^SE 
value. 

3.8.7 BOOLEAN AND RELATIONAL EXPRESSIONS 



lean and relational expressions are formed according to the 
following rules? 

A Boolean or relational expression may consist of a single element: 

NOT (A) 
XO 3-. 14159 

Single elements may be combined through the use of the Boolean 
opera tcrs AND and OR to form compound expressions such as: 

A AND B 
X OR I 

Any expression may be enclosed in parentheses and regarded as an 
element: 

(T OR S) AND (R OR Q) 



3.8.8 EXPRESSION EVALUATION 



re ss ions are evaluated left to right if the operators are of equal 
precedence, and there are no parentheses. If there are parentheses in 
the expression, the sub-expression within the innermost parentheses is 
evaluated first. Not all operators have equal precedence - operands 
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which are operated on by an operator of high precedence are evaluated 
before operations of low precedence. 

The precedence of operators is: 



1« 

2-. 

3. 


Expressions in parentheses 
Exponentiation and negation 


•4. 


+,- 


5. 


<s,<> 


6. 

7. 
8. 


ss,LXOR 


9. 
10'. 


.NOT,LNOT 


11. 


OR, LOR 


12'. 


(s) ASSIGNMENT 
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3.9 MULTIPLE STATEMENTS 

A double colon (::) terminates a POWER BASIC statement and can 
therefore be followed by another statement on the same line. This 
saves memory, speeds execution and also allows for better program 
segaentation. A common divisor program using multiple statement lines 
is illustrated below: 

The following examples demonstrate multiple statement lines. Note 
that this is not an executable program. 

10 PRINT " A"," B"," Cj^GCD" 

20 READ A,B,C 

30 XsAs: IsB:: GOSUB 200 

40 XsGjs TsCs: GOSUB 200 

50 PRINT A,B,C,Gj: GOTO 20 

60 DATA 32-, 384-, 72 

200 Qs DIP (X/I):: RsX-Q»I 

210 IF RsO THEN GsY : : RETURN 

220 XsX:; I=R:: GOTO 200 

All POWER BASIC statements may be preceded and followed by a double 
colon in multiple statement lines with the exception of the NEXT, 
DATA, and REM statements. The NEXT statement should not be preceded 
by another statement (i.e., should be the first statement of the 
line), the REM statement should not be followed by any statements on 
the same line, and the DATA statement should not be proceeded or 
followed by any statement on the same line. 

3-. 10 KE2B0ARD MODE 

The Host POWER BASIC Interpreter executes statements in either 
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Si Y«et!L7%'*^H"^ ^«° ^^''^^ ^^ ^P«*' statements and coaaands 
O^f and on?v i/ ^^^"-"^ Co^ands and Section 5 for Basic StatSs! 
^t^l^J:^ ^°* '^"^^^ '^y ^^ ^^^"^^ P«^ ^« «ith no statements 

In execution mode, the program counter moves fehv.«„efK i.>,^ 

result L^«^.» a carriage return and POWER BASIC will print the 

resuit. in the examples below all powpa TaacTr ««.»« T- 

underlined for clarity. responses are 

PRINT 12»12j 144 
Jl/SiS^^S; 0.3333333 27 ' • 

J4«AT!I1; 3'll4li9J " ~" 
|SIN(AmiJ;SQR2; 0.70710 68 1.414214 

; EXP 1 J COS ( 4»ATN1 ); 2.718 28 "TT 

53*34/2343-4+2 (3-»-5); 252.008 4 
Islst K=2:: PRINT I-+K;°T^ 

trl^ff^^^l ^°®^ *'*'' ^* executed in keyboard mode only if entered on 
one line; however, the loop cannot be ESCaped from entered on 



CONnNUE 


PURGE 


LIST 


RUN 


LOAD 


SAVE 


NEW 


SIZE 


NUMBER 


SOURCE 




STACK 



3o11 ERRORS AND ERROR LISTING 



The first run of new program may be free of errors and ^-f^o fh^ 

ItZlnt fndTVi .'"' " ^^ '""^^ »«^« «°»-^° tSarerrd^s^wIL'b'e 
present and wxll have to be corrected. Errors are of two types! 
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errors of form (syntax, arithmetic, structure, or gramnatical errors) 
which prevent the running of the program, and logical errors in the 
program which ciuse the computer to produce either the wrong answers 
or no answers. :- 

Errors of form cause the eiror code and statement number in which the 
error occurred to be printed and program execution stops. Logical 
errors are often much harder to uncover, particularly when the program 
gives answa»s vdiich seem to be nearly correct. In either case, after 
the errors are discovered, they can be corrected by changing lines, by 
inserting new lines, or by deleting lines from the program. A line is 
changed by typing it correctly with the- same line number; a line is 
inserted by typing it with a line number between those of two existing 
lines; and a line is deleted by typing its line number and pressing 
the cairiage return key. A line can be inserted , only if the original 
line numbers are not consecutive numbers. For this reason, most 
programme's will start out usiiig line numbers that are multiples of 
five or ten to leave space for the inevitable changes and corrections. 

CorrectioM can be made at any time before or after a run. Since the 
computer sorts lines (and arranges them in order), a line may be 
retyped out of sequence. Simply retype the offending line with its 
original line number. If after examining a program the errors are not 
obvious and there are no grammatical errors, carefully select and 
insert temporary PRINT statements to see if the machine is computing 
what you wanted. 

POWER BASIC displays error messages to indicate any errors which 
occur during program entry or execution.. POWER BASIC reports all 
errors using basically three fomats. 

The first format displays the error message and the statement number 
where the error occurred according to the following format: 

»*»xxxxxxx»»* AT nrr 

where: 

X]CCX is the error message 
THI is the statement number 
Examples: 

***Syntax Error **» at 100 
•»»Read out of data »»* at 180 

This error format is disp-layed whenever errors are encountered during 
program execution, and program execution will be terminated at the 
offending statement. The error format' displays the statement line in 
which the error occurred. The offending statement line or other 
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segments of the program may then be edited to correct the reported 
error. 

The second format displays only the error message when an error 
occurs. These type of errors are detected during keyboard mode 
statement execution, during statement or command entry, or during 
program LOAMng from a device/file* They indicate that the most 
recently entered statement or command, or the iwst recently LOADed 
statement is in error • If the error is an error of syntax (ioe*, 
something is wong with the statement itself, typically a typing 
^rrar ^ an omission, or an unrecognizable statement), the error is 
first output, followed on the next line by a repeat of the preceeding 
statement or command with the cursor positioned at the offending 
character. If a syntax error is detected during program LOADing, the 
error is output and the offending statement is output on the next 
line, but no cursor positioning is perfonned* LOADing then continues 
with the next statement on the "device/file. If an error other than 
syntax occurs during command or keyboard statement execution, only 
the error is output. Any errors may then be corrected and the 
statement or command executed again « 



The third format displays errors reported by the TX990 Operating 
System. These errors are reported to the user as hexadecimal codes in 
the format of 

FILE I/O EHROH OXXH . 
FILE I/O ERROR OXXH AT TTTL 

where 

XX is the error code 

Tin is the statement number 

Ex^nples; 

File I/O Error 027H 

File I/O Error 026H at 70 

The following error codes and error messages may be issued by the 
POWER BASIC package. Refer to Appendix A-3 for the error codes and 
corresponding error messages reported by the TX990 Operating System. 

CODE ERROR MESSAGE 

1 s SIHTAX ERROR 

2 s UNMATCHED DELIMITER 

3 ^ INVALID LINE NUMBER 

4 s ILLEGAL VARIABLE NAME 

5 s TOO MANY VARIABLES 

6 s ILLEGAL CHARACTER 

7 s EXPECTING OPERATOR 

8 s ILLEGAL VARIABLE NAME 
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9 s ILLEGAL FUNCTION ARGUMENT 

10 s STORAGE OVERFLOW 

11 s STACK OVERFLOW 

12 s STACK UNDERFLOW 

13 ' NO SUCH LINE NUMBER 

14 s EXPECTING STRING VARIABLE 

15 = INVALID SCREEN COMMAND 

16 s EXPECTING STRING VARIABLE 

17 s SUBSCRIPT OUT OF RANGE 

18 s TOO FEW SUBSCRIPTS 

19 s TOO MANI SUBSCRIPTS 

20 s EXPECTING SIMPLE VARIABLE 

21 s DIGITS OUT OF RANGE 

22 s EXPECTING VARIABLE 

23 'S READ OUT OF DATA 

24 s READ TTPE DIFFERS FROM DATA TYPE 

25 s SQUARE ROOT OF NEGATIVE NUMBER ^ 

26 s LOG OF NON-POSITIVE NUMBER 

27 s EXPRESSION TOO COMPLEX 

28 = DIVISION BY ZERO 

29 s FLOATING POINT OVERFLOW 

30 = FIX ERROR 

31 s FOR WITHOUT NEXT 

32 s NEXT WITHOUT FOR 

33 s EXP FUNCTION HAS INVALID ARGUMENT 

34 s UNNORMALIZED NUMBER 

35 = PARAMETER ERROR' 

36 s MISSING ASSIGNMENT OPERATOR 

37 s ILLEGAL DELIMITER 

38 s UNDEFINED FUNCTION 

39 s UNDIMENSIONED VARIABLE 

40 s UNDEFINED VARIABLE 

41 s INVALID END-OF-USER RAM ADDRESS 
43 = INVALID BAUD RATE 

The following error messages result from the POWER BASIC/TX990 
•Operating System Interface: 

50 = END-OF-FILE OCCURRED 

51 s TABLE AREA FULL 

52 2 INVALID LUNO 

53 » INVALID PATHNAME 

54 s ZERO LENGTH RECORD 

55 s INVALID FILE ACCESS 

56 s POSITION ERROR 

57 s INCOMPATABLE FILE TYPE 

Notes Refer to Appendix A-3 for the additional and corresponding 
error messages reported by the TX990 -Operating System. 
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SECTION IV 
^ -r BASIC COMMANDS 

4%1 GENERAL 

POWER BASIC programs are created, executed, and debugged through 
interaction with the POWER BASIC system. The system recognizes two 
kinds of input: statements and commands. POWER BASIC commands direct 
and control system functions which include initiating computer 
operation, and storing and listing of programs. Commands cause 
^ediate computer interaction thereby allowing operator control. 
Statements perfora a sequentially assigned programmed task. Any 
command may be entered once BASIC has been initialized. An error 
message is generated when an imp roper- or illegal entry is attempted. 

Commands are used during program development and debug. For this 
reason, the Host POWER BASIC Interpreter will execute all of the 
coiaaands presented in this section. None of the POWER BASIC commands 
■ may be entered into any application programs, and the Configurator 
will not accept any of the commands of this section. Therefore the 
Target POWER BASIC Interpreter and application may not contain any 
POWER BASIC commands. 

^.2 - CONTINUE COMMAND 

Form: 

CONtiaue 

The CONTINUE command transfers control to the next statement of the 
' BASIC program after the occurrance of a break condition. (The RUN 

command always starts at the first line.) 

When the RUN command is entered, program execution begins at the first 
line and continues until a break condition occurs. The CONTINUE 
command may be used to continue execution after a break. 

The program will stop (or- break) when the user* enters the ESCape key 
during program execution, a STOP or END statement is encountered, or 
an error occurs within the progr^i. 
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n.3 LIST COMMAND 

Foras s 
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LIST <llne number> 

LIST <->line number>- 

LIST <lin'e nuinber><»line number> 

The LIST command lists all or any portion of the current program. 
Entering only the command forces the entire prDgram to be listed. By 
entering a line number* or range of the line numbers, specific 
portions of the program can be listed* Neither- the starting or- ending 
line numbers need to be an existing line number. POWER BASIC will 
begin listing at the first line number greater- than or equal to the 
starting line nimberand terminate listing at the last line number 
less than or- equal to the ending line number. 

Example: 

LIST 
results in a listing of an entire program, while 

LIST 100 
lists all the lines ffom 100 thnaugh end of program, inclusive. 

LIST -35 

lists all the lines fora the beginning of the program throu^ line 35, 
inclusive . _ 

LIST 90-120 

lists all the lines from 90 through 120, inclusive. 



4.4 LOAD COMMAND 



The LOAD cofflffland will read a POWER BASIC program into memory which has 
been previously "SAVEd" onto the specified device/ file. 
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Fom: 

LOAD /<string eonstant>l 
Kstring variableV 

The string eonstaat or* striag variable specifies the pathname of 
the device/ file from which the POWER BASIC program is to be read. 
Typical pathnames used in the LOAD command would be DSC:PR0G1/DEV, 
DSC2:7AL0E/CNT, CS1, of CS2. The actual pathnames of devices are 
defined during- TX990 Operating System generation. The usershould 
reference has particular system generation for the device names to be 
used in the formation of pathnames. Refer- to Section 5, paragraph 
5^.15.1 of this manual 'for- valid device/ file, pathname constnacts. 

r^ The LOAD command automatically opens the specified device/file, 

followed by a rewind operation. It then loads the program and 
perf'onns a close operation on the device/file. 

As statements are read from the device/file, they are interpreted into 
internal pseudo-code and stored into the user- prog ram RAM ar«a of 
POWER BASIC. If any invalid statements are read during LOADing, the 
corresponding error message, followed by the offending statement in 
which the ^rror occurred will be output on the terminal device. 
Invalid statements typically have errors in fora, such as syntax, 
structure, or- grammatical errors. The offending statement is not 
stored into the user- program RAM area of POWER BASIC, and the LOADing 
procedure will continue with -the next statement on the device/file. 
Loading continues until the end-of-file is read on the the specified 
device/file. Control then returns to the keyboard of the terminal 
device. 

When a POWER BASIC program is LOADed, only those statements with 
f statement numbers loaded from the device/file will be inserted into 

the user- program area. The statements already in memory having 
different statement numbs' s will not be affected. Any statements in 
memory which have the same numbers as the program on the device/file 
will be overwitten by the loaded program. 

Note that the user- must insure that the file specified by the 
LOAD statement does contain a POWER BASIC program which has 
been properly SAVEd in the file.' If a file' which does not 
contain a POWER BASIC program is specified by the argument of 
the LOAD statement (eg. , a file to which BINARY data has been 
written), unpredictable results may occur when this 
device/file' is accessed for- the LOAD. 
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Examples: 



LOAD "DSC2: PROG 1 /SRC" !LOAD BASIC PROGRAM FROM DISKETTE FILE 
LOAD "CSI" ILOAD BASIC PROGRAM FROM CASSETTE #1 

LOAD "DSCjCONTROL/PGI" ILOAD BASIC PROGRAM FROM DISKETTE FILE 

i 



4.5 NEW COMMAND 

Foms: 



NEW 

NEW <address> 

The NEW command without an address deletes the current user- program '-^ 
and clears all variable space, pointers, and stacks. POWER BASIC 
responds with "♦READY" and awaits the entry of new BASIC programs. 
The programs may be retrieved later if they have been SAVED. 

The fora of the NEW command with an addrsss parameter is used by the 
Host POWER BASIC to limit the amount of RAM which can be used by the 
POWER BASIC system for user- program area. When POWER BASIC is 
executed, it automatically sizes and clears the system RAM area 
starting ft»om the top of the POWER BASIC Interpreter and checking 
sequential memory locations up through memory until a write/ read 
mismatch is detected. All of the detected RAM area is then allocated 
to POWER BASIC to be used for interpreter overhead and user program 
area. Under some circumstances, it- may not be acceptable for POWER 
BASIC to use all available contiguous RAM. In some applications it 
may be required to rasenre a specif ic. block of RAM area for- use by the 
application. For example, a small area of RAM is required for any 
assembly language subroutines which are to be CALLed by the POWER 
BASIC program. For this reason, the NEW command with the address "^ 

parameter was introduced. The upper- bound of RAM memory is set to the 
specified address, and all POWER BASIC pointers are initialized to 
correspond to this new memory configuration. The Host POWER BASIC 
Interpreter will not use RAM above this address. Therefore an area 
of RAM can be reserved fo r application use from the specified address 
parameter- on up toward memory addrsss FTFFj^g. POWER BASIC verifies 
that the specified address is not less than the absolute minimum valid 
address (that is, it will not permit .the user to "walk over" POWER 
BASIC >. This address denotes the end of the POWER BASIC InterprBter- 
and will vary between operating systems. If the specified address is 
less than this value, an INVALID END-OF-USER RAM error- will result. 
Howev«», no addrsss checking is performed to verify that the specified 
address is a valid RAM address. Care must be taken when specifying 
the addrsss to make sure that RAM does acutally exist at that address 
and is contiguous from low memory (OOOO^g) up to that address. Eratic 
operation of POWER BASIC will result if an invalid RAM aeldress is 
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specified. The user must also be sure that the software which uses 
the free area does not overlap past the specifild addrOs into thi 
. workspace area of POWER BASIC. In addition to setting the UPPER 
aefflory bound, the HEW eemaaad also deletes the current user program, 
and clears all variable space, pointers, and stacks. 

Examples s 
NEW 
NEW 0E800H 

4.6 HDMBER COMMAND 

Pones 

NUMBER 

NUMBER <start line number> 

NUMBER <start line number><increment>- 

The NUMBER command enables the automatic line nianber prompt. This 
prompt is terminated by a null line entry. The simplest form of the 
command (the command word itself) assigns 100 as the starting line 
number and prompts the line numbers in increments of 10, 

A different starting line number can be specified as a parameter of 
the command. Thus, the command 

NUMBER 1000 

prompts the line numbers in increments, of 10 starting at line 1000. 
The comm^id 

NUMBER 25-, 5 

prompts the line numbers in increments of 5 starting at Une number 
25. 

Entering a null line by entry of the carriage return key immediately 
following the line number prompt will terminate automatic line number 
prompting. 

Automatic line numbering with- fixed start and increment values may 
also be initiated via the line-feed entry key as explained in Section 
• 3",- paragraph 3.3.3. 

4.7 PURGE COMMAND 

The PURGE command allows the user to delete specified segments of the 
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current program. 

Form: 

<Iine n'amber>. PURGE <N1> TO <N2> 
PURGE <N1> TO <N2>- 

wfaere N1 and H2 are the start and end line numbers, respectively. 

The PURGE statement is designed to delete blocks of consecutive 
BASIC statements, PURGE will delete all statements from N1 to N2 
inclusive. POWER BASIC will begin deleting statements at the first 
statement greater than or equal to N1 and will continue to the last 
statement less than or eqtial to N2e 

Examples': 



/flS^HV 



LIST 

10 REM SUBROUTINE TO PRINT I AND I»I 

20 FOR Isl TO 10 

30 PRINT I, I»I 

40 NEXT I 

50 STOP 

PURGE 15 TO 45 
*READr 

LIST 
10 REM SUBROUTINE TO PRINT I AND I»I 
50 STOP 

4.8 RUN COMMAND 

Fona: 

RUN 

The RUN command clears all variable space, pointers, and stacks and 
directs the system to begin execution of the current BASIC program at 
the lowest line nuznber. The command 

RUN 

win "execute the user's POWER BASIC program currently in RAM. 

4.9 SAVE COMMAND . 

The SATE command will write the users POWER BASIC program currently in 
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Fora: 

SAVE •.<?tring constant>- 
<striag variable> 

The string eoastaat or- striag variable specifies the pathname of 
the deviee/file to which the POWER BASIC pirsgiam currently in meoory 
will 'be written. Typical pathnaaes used in the SATE coaaaand would be 
DSCsPROCESS/CNT, DSC2sM0T0R/PRG, CS1, or CS2, The actual pathnames of 
the devices are defined during TX990 Operating System generation. The 
user should reference his particular system generation for the device 
aames to be used in the formation of pathnames. Refer to Section 5, 
paragraph 5.15.1 for- valid device/ file pathname constructs. 

The SATE command automatically opens the specified device/file, 
followed by the rewind operation. It then saves the program and 
performs a close on the device/file. 

If the program is SAVEd to a diskette file, the file must be created 
by the BDEFS orBDERF statements before the SATE command is executed. 
Typically, BASIC programs are SATEd into sequential files, since these 
files are only used by the SATE and LOAD commands, and otherwise a.rs 
not accessed by the user. Attempts to SATE a program to a diskette 
file which does not exist will result in a TX990 undefined file error. 

The program is. output in source form, that is, in POWER BASIC 
statement format; in contrast to the pseudo-code fora in which it is 
iatersally stored. Since SATE performs in this manner, the user may 
enter a SATE "LP" conmand and the program will be "listed" to the line 
printer- device. 



^ BDEFS "DSC2SPR0C/SRC" IDEFINE FILE FOR SATE (See Section 5.15 2) 

SATE "DSC2IPR0C/SRC" !SATE POWER BASIC PROGRAM TO DISKETTE FILE 

SATE "CS1" ISATE POWER BASIC PROGRAM TO CASSETTE #1 

SATE «LP« ISATE (LIST) POWER BASIC PROGRAM TO LINE 

PRINTER 

4.10 ' SOURCE COMMAND 

Formj 

SOURCE 

The SOURCE command prints the number- of source bytes in the 
currently loaded user's program. This indicates the number of bytes 
that would be written by the SATE, command. 
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Example: 



SOURCE 

SRCE s 243 BITES 
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STACK COMMAND 



Fonn: 



STACK 

The STACK conmand lists the user GOSUB stack beginning with the first 
GOSUB return statement number- pushed on the stack. These numbers 
indicate the return statement number-fornested , GOSUB 's in the user's 
program. This command is helpful in the debugging of an application 
program. 






Example; 



10 


•GOSUB 100 


20 


AsSQR(I) 


99 


STOP 


100 


REM 


110 


GOSUB 200 


120 


1=5 


190 


RETURN 


200 


REM 


210 


REM 


280 


STOP 


290 


RETURN 


RUN 




STOP AT 280 


STACK 




#20 




#120 




•READY 



x4<*^ 



The STACK command will point back to a calling line that contains 
multiple statements to indicate that execution will continue with the 
statement immediately following the. GOSUB. The following example 
illustrates this. 

Example: 



10 


•GOSUB 100 


20 ■ 


AsSQRd) 


99 


STOP- 


00 


REM 
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110 


•GOSUB 200 


120 


Is5 


190 


RETURN 


200 


REM 


210 


REM 


280 


STOP 


290 


RETURN 


RUN 




STOP AT 280 


STACK 




#20 




_ ' . #110 




•READY 


SIZE COMMAND 


FOBBJ 




SIZE 





J=5»5 



The SIZE command monitors memory usage by listing the current 
program size, variable space allocated, and the free memory in bytes. 



SIZE 

PRGM: BYTES 

?ARS: BYTES 

FREE: 18850 BYTES 
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SECTION V 
BASIC STATEMENTS 



5\ 1 GENERAL 



This section discusses the POWER BASIC program statements. 
Statement formats are presented and their-tises are described. 

During BASIC program execution, control may pass to any statement. 
Some statements have no effect on the program when encountered and are 
called nonexecutable; all others are called executable. 

Statements form the basis of all functional POWER BASIC programs. 
^^. . -Each statement of a BASIC program may occupy only one line; however; 

numerous statements may appear on each line when delimited by a pair 
of colons (::). 

BASIC statements are divided into the following categories s 

• Remarks 

• Dimension Declarations and Specifiers 

• Function Definition 

• Assignment 

• Control 

• Input/Output 

^^^ ♦ Interrupt Processing 

• CRU Base Assignment 

• Time of Day 

e Randomize Number Seed 

• Program Escape/Noesc 

• External Subroutine 
» File Management 

Table 5-1 briefly describes each statement. 
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TABLE 5-1 
POWEH BASIC STATEMENTS 



STATEMENT 


FUNCTION 


USE 


REM 


Cosaaent Line 


Program documentation/ explanation 


DIM 


Size Specifier 


Dimensions strings, vectors, and 
matrices 


DEF 


Function Definition 


Defines a statement • function 


LET' '' 


Assignment 


Evaluates expressions and assigns 
value 


EQUATE 


Assignment 


Two symbols refer to the same 
variable 


GOTO 


Control 


Transfers unconditionally 


IF 


Control 


Conditionally executes statement(s) 
on TRUE ■ condition 


ELSE 


Control 


Conditionally executes statement(s) 
on FALSE condition 


C50SDB 


Control 


Transfers to BASIC subroutine 


RETURN 


Control 


Returns from BASIC subroutine 


POP 


Control 


Removes top return address from 
GOSUB stack 


ON 


Control 


Computed GOTO or GOSUB 


FOR 


Control 


Defines top of loop and loop 
parameters 


NEXT 


Control 


Delineates loop scope 


ERROR 


Control 


Transfers on error condition 


STOP 


Control 


Stops program 


END 


Control 


Stops program 


B2E 


Control 


• 
Terminates POWEH BASIC and returns 
to TX990 Operating System 



5-2 




/0^P\ 



INPUT 
PHINT 
TAB 
DIGITS 

SPOOL 



RAHDOM 



ESCAPE/ 
NOESC 

CALL 



TABLE 5-1 (cent) 
BASIC PROGRAM STATEMENTS 



FUNCTION 



USES 



InteToal Input 
Internal Input 
Internal Input 

I/O 
I/O 
I/O 
I/O 

I/O 



UNIT 


I/O 


BAUD 


I/O 


IMASK 


Interrupt Processing 


TRAP 


Interrupt Processing 


IRTN 


Interrupt Processing 


BASE 


CRU base assigjsment 


TIME 


Time of day 



Set Random seed 



Program escape/ 
no escape 



Reads from internal data block 

Defines internal data block 

Resets internal READ to first data 
block element 

Reads from terminal 

Prints on output device 

Formats output into columns 

Specifies number of significant 
digits output 

Assigns unit number to specified 
file/device 

Designates print output device 

Designates baud rate of I/O device 

Sets interrupt mask 

Assigns interrupt level to interrupt 
subroutine 

Returns from interrupt subroutine 

Sets the CRU base address 

Sets, displays, or stores the 24« 
hour . time of • day clock 

Sets the seed of the pseudo random 
number generator 

Enables or disables the escape key 
to interrupt program execution 



Extenlal Subroutine Transfers to external subroutine 
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STATEMENT 



BDEL 

BCLOSS 

RESET 
COP! •" ' 

BDEFR 
BDEFS 
BOPEN 

BINAEI 1 



TABLE 5-1 (cont) 
BASIC PROGRAM STATEMENTS 



FUNCTION 



File Management 
File Management 
File Management 
File Management 
File Management 
Fil€f Management 
File Management 

File Management 



BINARY 2 File Management 



BINARY 3 File Management 



BINARY 4 File Management 



USES 



Deletes specified file 
Closes specified file 
Closes all open files 
Copies one file to another 
Defines a relative record disc file 
Defines a sequential disc file 

■Opens specified file for sequential 
or relative record access' depending 
on file type 

Sets BINARY luno and specifies the 
number of bytes to be read or 
written for any subsequent BINARY 
commands . 

Writes an assigned number of bytes 
from each expression to the BINARY 
luno. 

Enables the user to read an assigned 
number of bytes into each variable 
from the BINARY luno. 

Allows access to a given byte posi- 
tion within a relative record disc 
file. 



5.2 COMMENT OR REMARK (REM) STATEMENT 
Form: 

[line numbefj REM text 
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The REM statement is used to insert renaries (coaments) in a program, 
REM may eontain any textual information. It has no effect when 
encountered in exeeutioni howeveri its line nua^er may be used as the 
aiiument of a GOTO or GOSUB statement. Tail remarks may also be 
inserted into a program by separating the remark field from the 
statement field by an exclamation point (!). For- additional 
infoaaation on tail remarks, refer to Section 3.M-.3. 



10 REM THIS IS A COMMENT 
.- ' ■ 100 REM CHECK FOR X=0 

Target POWER BASIC Interpreters Note that no REM statements crtail 
remajks are Configured into the final Taiiget POWER BASIC Interpreter 
to conserve user- program stomge area required in the final 
application. 

5.3 I 

DIMEKSION STATEMENT 

Dimension declarations are used to specify the size attributes for 
subscripted variables wi-fchin the. program. 

Fom: 

Oj^e number] DIM <var( dim [.dim].. .)>[,... .T 

The DIM statement dynamically allocates user variable space for array 
variables. Dimensioned (array) variables must be declared by the DIM 
statement before the variables are used. Once dimensioned > attempts 
to redimension an array variable to a larger- array size will result in 
an ^rros^ message and attempts to redimension to a smaller size will be 



Array sizes are specified by indicating the maximum subscript values 
in parentheses .following the array name. Subscripts of dimensioned 
variables may be any numeric quantity including constants, simple 
variables, other- dimensioned variables, or even function calls. If a 
floating point value is returned for- the subscript value, only the 
integer- portion will be used in the dijnension statemement. The number 
of dimensions and the dimension size for the array declaration is 
limited only by the user's available memory. An error will occur if 
the dimensioned variable requires more variable space than is 
currently available in the user's partitioii'. Dimensioned variables 
always use the subscript as the first element in the array. 
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Examples: 

10 DIM A(10),B(10,20) '- 

100 DIM A1(10),B1(20,30),B15(10,10,10) 
DIM CAT(C,D),D0G(SQR(N),3,F) 

The first statement allows for the entry of an array of 11 elements 
(0-10) into A, and of an array of 11 x 21 elements into the two 
dimensional array, B, The two remaining statements dimension arrays 
in a similar- manner; 

String variables must be dimensioned as numeric variables, e.g., $A 
must be dimensioned as A(10) not $A(10). Thereafter, the dimensioned 
numeric variable may be referenced as a string variable by preceding 
the variable with a dollar sign ($). The string array A dimensioned 
above should be referenced as $A(0) through $A(10). 

Examples : 

20 DIM CAT(10),DOG(8) 

This statement defines CAT to be a one dimensional array with 11 
elements and defines DOG as a one dimensional array of 9 elements. 
Hereafter, these arrays may be considered as string arrays by 
referencing the variables via $CAT(0) through $CAT(10) and $DOG(0) 
through $D0G(8). 

Strings are stored one character per byte with a null character used 
to terminate the string. Hence, simple string variables and single 
array elements which are 6 bytes in length can contain up to five 
characters. Dimensioned string variables can contain up to the number 
of elements times 6 minus 1 characters in Configurable BASIC, 
therefore, the dimensioned string variable $CAT can contain up to 65 
characters. 

5.4 FUNCTION DEFINITION 

The DEF statement defines a user function. The defined functions are 
' executed only when the function is referenced. 

Fonns: 

[line number] DEF FN <lettert>s <expression> 

[Une number] DEF FN <letter> (parmi ,parm2 ,parm3 ) s <expression> 



wheres 



parametere are single alphabetic letter dummy variables 
expression is any valid POWER BASIC expression. 
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?|.^^^ statemeat may appear anywhere within a BASIC program and the 
eefined functions may be used in any expression. That is, onee 
defined, the functions may be used in the same way as the built-in 
mathematical • functions escplaiaed in Section 7. When the function is 
referenced, the expression is evaluated and the parameters, if any, 
,are replaced by the arguments given in the reference. Within the 
expression the parametere may appear only as numeric variables. The 
user may define functions using up to three dummy parameters. All 
(dummy) parameters may only be single character variables in the 
function definition. However, when calling the function the user may 
use any valid POWER BASIC variable (either- simple or- dimensioned) to 
replace the dummy variables of the called function. 

-.The expression may include any combination of intrinsic functions, 
other- user -defined functions, or may involve any other- variables in 
addition to the ones used in the argument of the calling function. 
Paiameter- names are dummy (local) variables of the defined function, 
and have no meaning outside of the function definition. 

The use of the DEF statement is limited to those functions whose 
expression may be evaluated within a single QASIC statement. 

The name of the defined function must be three letters, the first two 

of which must be FN followed by a single letter; e.g,, functions FNA 

throu^ FN2 may be' defined by the user. The same letter which defined 

the function may also be used as a parameter of the function as shown 
below . 

The following 'examples illustrate the various forms of the DEF 
statement. Note that this is not an executable POWEB BASIC program." 

20 DEF FNA(X,I)aX/T+5 

30 DEF FNB a A/B + C-15 

r^ 40 DEF FNC(I,J) s I»K/J + FNB - FNA(I,J) 

50 DEF FND(N) r N«N/2 

60 DEF FNI(I,J) s I»J/SQR(I) . 

5.5 VARIABLE ASSIQIMENT 

5.5-. 1 LET STATEMENT 

. The LET statement assigns a value to a variable where the- variable is 
set equal to an expression consisting of variables and/or- constants 
separated by operators. The variable teing evaluated may appear 
within the expression. The newly calculated value of the variable 
replaces the old value. 
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In POWEH BASIC the letters LET may be omitted from the statement so 
only an equation appears. The LET statement may have either of the 
following forsBs: 

|Line numberj LET <7aj:iable> s <expression> 
" ',ne numbe^ <variable> = <expression> 



t 



where 

variable' is a string variable, numeric scalar variable, or array 
element . 

The assignment statement assigns an expression value to a variable. 
The variable and the expression must both be eitiia* string or numeric. 
The following examples illustrate the assignment' statement. Note that 
this is not a meaningful POWER BASIC program, ■'^ 

As5 

BslO 

LET CsA+B 
10 LET X»1 
20 LET $A(2)=$C+''N0W" 
30 LET Q2(L)=Q2(L+1)-i.3 
^0 LET H=6 
50 D=5 
60 FsA/B*3 

100 LET Z(I,J) £ 3*X-4»Y 
120 ^ABs^STOP" 

.5.5.2 EQUATE STATEMENT 

The EQUATE statement enables a simple variable to be equated to 
another simple variable or to an element within an array. '^ 

Fo na: 
[line numbe^EQUATE<simple varUble>,<variable>;<simple variable>,<variable>. . . 

The EQUATE statement may appear anywhere within the program. The 
simple numeric variable is equated in the symbol table to the 
associated numeric variable and thereafter either may be used when 
referencing that variable. This is a valuable technique for- passing 
paiameters through variables to a common subroutine. The subroutine 
may access its parameters from specifid simple variables (e.g., A, B, 
and C), and the calling routine may assign these simple variables via 
an EQUATE prior- to execution of the GOSUB statement. The user may 
equate any other simple variable or array element to these simple 
variables. 



5-8 



Simple variables may also be equated to specific bytes within a 
diaeasioned variable, (e.g., EQUATE TAG, FLAG [0j3]). These bytes may 
then be accessed by specific names and functions as. byte flkgs within 
the application progzam. 

s 
I 

In applications where memo 17 usage is ciltical, the user-^ould note 
that simple variables (e.g., A,$B) require less storage allocation 
when referenced in a program than dimensioned variables (e.g., 
A(1),$B(1)). Therefore, in applications where dimensioned variables 
are frequently referenced, memory area may be conserved by using the 
EQUATE statement to assign dimensioned variables to simple variables. 

The following examples illustrate the use 'of the EQUATE statement. A 
carriage retura is represented by CCH), and all user responses are 
underlined. 

Examples: ° 

10 DIM Ado) 

• 20 EQUATE NAM,A(0);PHN,A(5) jSSN,A(7) 

30 INPUT $A(0),$A(5),$A(7) 

MO PRINT $NAM,$PHN,$SSN 

50 STOP 

RUN 

• '^OHN DOE (or) ; 492-1356 (or) : 486-57-4392 (cr) 

JOHN DOE "592-T35F " 4H^-W"'539? ~ 

STOP AT 40 

Additional examples: 

10 EQUATE I1,I(1-);T23, T(2,3); F2, FLG(0;2) 
20 EQUATE I1,PI;JJ,P2 
30 • GOSUB 1000 

1000 II = I1«ATN(1) 
1090 RETURN 

Target POWER BASIC Interpreter: The EQUATE statement is not supported 
by the POWER BASIC Configurator, therefore the EQUATE statement 
should not be present in a final application pnsgram which is to be 
configured into a customized (Target) POWER BASIC Interpreter. 

5.6 CONTROL AND COMPUTED TRANSFER STATEMENTS 

BASIC statements are executed sequentially unless altered by control 
statements. Control may be accomplished by an unconditional branch, 
s\Jb routine branch, computed branch, or loop. ] 
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5.6.1 UNCONDITIONAL GOTO STATEMENT 

When the computer- encounters a GOTO statement, it jumps to the program 
line number specified in the statement. The program executes the 
statement at the speceified line number- and continues in sequence with 
the statements that follow. 

Fom: 

jline numbe^ GOTO <line number> 

The "GOTO" statement must be entered without any embedded blanks. If 
the GOTO statement is not preceded by a line numberj program execution 
begins at the line number specified immediately after the- GOTO 
statement . 

Examples: 

GOTO 200 Begins execution at statement 200 
100 GOTO 140 Transfers control to statement 140 

The following program illustrates the GOTO statement: 

20 INPUT A 

30 -GOTO 50- 

40 STOP 

50 PRINT A . 

60 GOTO 40 

^e program execution sequence is line numbers 20, 30, 50, 60 and 40 
where execution stops. 

5. 6. 2 CONDITIONAL IF-THEN-ELSE STATEMENT . 

The IF-THEN-ELSE statements provide capability for conditional 
execution of program statements. 

5.6.2.1 IF-THEN STATEMENT 

The IF statement alters sequential execution of the program dependin* 
on the state of the specified condition. 

Foots: 
Jine numbe^ IF <expression> THEN BASIC<statement(s)> 



jLine number 



IF <:Bxpression> relation <expression> THEN <BASIC statement (s)> 



line number- IF <stringxrelationxstrin©> THEN<BASIC 3titement(s)> 



line number 
line numbe^ 



IF <string> THEN<BASIC statement (s)> 

IF <string><relationX3tringx,expression>THEN<aASIC statement (s)> 



.^^'•bn. 
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The condition may be any variable, numeric expression, relational 
expression, logical expression, string variable, string relational 
expression, or- function which can evaluate to a zero or- non-zero 
value. Two expressions or strings are compared according to the given 
relation and a true or false condition results. If the second string 
is followed by a comma, the expression following the comma indicates 
the number of characters to be compared. If only a single expression 
or string is given, the condition is considered false if the expres- 
sion is zero or the string is null; otherwise, it is considered true. 

If the condition is true, the statement (s) following the THEN clause 
on the same line will 'be executed. If the condition is false, the 
statement on the line following the IF-THEN statement will be the next 
statement executed. Any POWER BASIC statement or statements (including 
••-GiOTO's and other IF-THEN statements) may immediately follow the THEN 
clause. They cannot extend to the nesxt statement line because 
^ s-^tement execution continues at the next statement line when a false 

condition occurs. The IF and THEN clauses must appear on the same 
statement line. 



20 IF AsO THEN GOTO 100 

30 IF SQR(J) s4 THEN KsJ»J/I:: PRINT J,K 

JlO IF 1+2 THEN PRINT I 

50 IF $As$B THEN PRINT $A 

60 IF $A THEN $Bs$A 

70 IF CRUdI) THEN CRU(12)= 1t:G0T0 200 

80 IF $As$B,3 THEN GOTO 200 (compares first three characters 

of $A and $B) 

5.&.2-.2 ELSE STATEMENT 

The ELSE statement enables conditional execution of POWER BASIC 
,«?**>> statements depending upon the true or false condition of the last 

executed IF statement. 

Form; 

[line numbejij] ELSE <POWER BASIC statement> 
•J 

' IF-THEN statements set the ELSE flag to indicate the true or false 
, condition of the last executed IF-THEN statement. Subsequent ELSE 

statements use the ELSE flag to determine whether the statement(s) 
following the ELSE are to be executed. When the IF condition is true, 
the TEEM clause will be executed and all subsequent ELSE statements 
will not be executed. When the IF condition is false, the THEN clause 
will not be executed and all subsequent ELSE statements will be 
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executed. The E^LSE statement must not be placed on the same statement 
line as the preceding IF-THEN statement because when the IF condition 
is false, no further- statements on the IF-THEN line will be executed, 
and execution will continue with the next statement line. The ELSE 
flag remains set to the true or false condition until the next IF-THEN 
statement is executed at which time the flag is cleared and set to the 
new true or false condition* Several ELSE statements may appear 
between each IF-THEN statement, and each of these will be executed 
when they are encountered if the last executed IF-THEN statement 
resulted in a false condition* If a true condition resulted, each of 
these statements will ^e sld^pped* An ELSE statement always uses the 
last IF statement executed as its reference regardless of where it 
physically lies within the POWEH BASIC Progzam. This enables blocks of 
stateisents to be conditionally executed or skipped « 

Examprle: 

The following program computes the function and prints the result: 

Statement of functions 

forX<1, f=ABS(X>, 
for 1< sX<2, f=SQH(X), 
,for2< sX, fsABS(X)--SQR(X) 

Program solution*: 

10 IF X<1 THEN FsABS(X) 

20 ELSE IF X<2 THEN FsSQR(X) 

30 -ELSE FsABS(X>-SQR(X) 

40 PRINT X,F 

5.6,3 SUBROUTINE (GOSUB, POP, AND RETURN) STATEMENTS 

BASIC programs may contain internal BASIC subroutines. An internal 
subroutine is a sequence of BASIC statements perfonning a well- 
defined function or operation within the POWER BASIC program. Three 
types of statements govern access to a subroutine: a GOSUB statement 
for- entry into the subroutine, a POP statement for exiting nested 
subroutines, and a RETURN statement for return to the calling program* 



Forms: 



(line numbed GOSUB <line number> 
Gline number^ POP 
^ine numbe^ RETURN 



,v-'"'*^!\ 
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An iateraal POWEB BASIC subroutine may be invoked ft-om any point 
within the program by using a GOSUB statement which specifies the 
^zTd ^!^?* ®^ ^^® subroutine as a line number; Execution of the 
GOSUB statment pushes the address of the statement immediately 
following the GOSUB statement onto the GOSUB stack for retura and 
passes execution to the specified line number, 

A RETURN statement placed in the subroutine is an exit point from the 
internal POWER BASIC subroutine. A RETURN statement should be placed 
at each logical end of all subroutines. The RETURN statement causes 
execution to resume at the first statement following the GOSUB 
statement that transferred to the subroutine. During this transfer 
the top retura address is removed from the GOSUB stack. All 
subroutines should be exited only via a RETURN statement so the top 
return address will always be removed from the' GOSUB stack. 
fasiJTon^^*^^* Jesuits occur- if a subroutine is exited in any other 

In Figure 5-1 -GOSUB 90 involves statements on line numbers 90 (start 
of subroutine), 100, and 110 (end of subroutine). If a GOSUB 
statement is used, the subroutine it branches to must contain at 
least one RETURN statement. The example illustrates the simplest use 
of GOSUB and RETURN. The arrows indicate the flow of control in the 



/m^n^ 



10 
20 
30 



90 

100 

110 



X s 2 
GOSUB 90 
X s X+Z 



2 = 2«X-1 
X s x/z 
RETURN 
FIGURE 5-1 
GOSUB Example 
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Subroutirres may be nested by a subroutine containing a call to 
another subroutine? the inner subroutine is caJ.led a nested 
subroutine. Subroutines may be nested up to 20 levels in Configurable 
POWER BASIC. 

A return address (first line number after- the GOSUB) must be stored 
for- each GOSUB statement until that statement is executed. The 
program in the following example contains nested subroutines and shows 
the actual execution sequence. Each GOSUB to a subroutine must be 
accompanied by at least one RETURN statement per exit path. The 
nested program and execution sequence of the example demonstrate entry' 
to and exit ft'om a subroutine. 

LIST- ' 

10 PRINT "ROOTS OF QUADRATIC EQUATIONS" 

20 PRINT 

30 REM - ENTER COEFFICIENTS A,B,C OF A*X«X +B»X+C 

40 INPUT "COEFFICIENTS A= "jAj" 3= »;B;" C= ";C 

50 GOSUB 100 

60 REM - RESTART OR END PROGRAM? 

70 INPUT "MORE DATA (IsIES, 0sN0)?-"$1;N 

80 IF NO THEN GOTO 20 

90 STOP 

100 REM - CALCULATE S=B*B-4«A*C . 

1 10 S=B^2-4»A*C 

120 REM - COMPLEX ROOTS? 

130 IF S<0 THEN GOSUB 200 . ! COMPLEX ROOTS 

140 ELSE GOSUB 300 IREAL ROOTS 

150 PRINT I OUTPUT BLANK LINE 

160 RETURN 

200 RJM - CALCULATE COMPLEX ROOTS 

210 QsSQR ABS (S) ""^ 

220 R1s-B/(2»A) IREAL PART 

230 R2=Q/(2»A) ! IMAGINARY PART 

240 PRINT "ROOTS (-COMPLEXES ";R1:" + OR -n5R2:" I" 

250 RETURN 

300 REM - CALCULATE REAL ROOTS 

310 IF SsO THEN QsO 

320 ELSE QsSQR (S) 

330 R1s(-B-Q)/(2»A) IROOT 1 

340 R2=(--B+Q>/(2»A) IHOOT 2 

350 PRINT "ROOTS (REAL): "jRlj", ";R2'** 

360 RETURN 

would produce the following rssults: 
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RON 

ROOTS OF QUADRATIC EQUATIONS 

COEEFICIENTS As 2 Bs 1 C- --1 
ROOTS (REAL): -i, 0.5 

MORE DATA (IsIES-, 0=»0)? 1 

COEFFICIENTS A= 1 B= i? C- 6 

ROOTS (COtffLEX): --2 * Or"- 1%iJl42l4 I 

MORE DATA (IsXES, OsNO)? 
STOP AT 90 

The follbwiag example shows the' ^^fA^M^-,- 

example. Note that ^ retu]^ are oJ^f «.l ? sequence of the ab< 

*^ rewros are performed via RETURN statements 

Execution sequence: 



10 
20 
30 
40 
50 

100 
110 
120 
130 
140 

300 
310 
320 
330 
340 
350 
360 

150 
160 

60 
70 
80 
20 
30 

40 



PrS? "^^^^^ °^ QUADRATIC EQUATIONS" 

REM - ENTER COEFFICIENTS A B C 01? a«r»v »«^ 

REM - CALCULATE Ss B«B-4«A*C 
Ss BA2-4*A»C ° » ^ A C 

REM - COMPLEX ROOTS? 

^ S^p^^T^°!^ 2°° 'COMPLEX ROOTS 
ELSE GOSUB 300 jrsaL ROOTS 

REM - CALCULATE REAL ROOTS 

IF SsO THEN QsO 

ELSE Q=SQR(S) 

Ris (-B-Q-)/(2«A) • rRooT 1 

R2s (-B*Q5/(2*A) .'hSS? 2 

PRINT "ROOTS (REAL): -Rl-n «. ^ - 

RETURN '^'» » ,2 



PRINT 
RETURN 



1 OUTPUT BLANK LINE 



m - RESTART OR END PROGRAM? 
INPUT- "MORE DATA (l-rES", 0=h6)'> m-H 
IF NOO THEN GOTO 20 ' 

PRINT " 

^r,Z S!^ COEFFICIENTS A,B,C OF A*X»X *B»-*r 
.INPUT ^COEFFICIENTS A. "^a!"' B. ^^3^' g ^^ 



50 -GOSUB 100* 
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100 REM - CALCULATE Ss B«B - 4»A*C 

110 • SsB^2-4»A»C 

120 HEM - COMPLEX ROOTS? 

130 IF S<0 THEN GOStJB 200 ! COMPLEX ROOTS 

200 REM - CALCDUTE COMPLEX ROOTS 

210 Qs SQR ABS (S) 

220 HI s -B/(2«A) • !REAL PART 

230 R2= Q/(2»A) ! IMAGINARY PART 

240 PRINT "ROOTS (COMPLEX): "jRI;" + OR -";R2j" I" 

150 PRINT f OUTPUT BLANK LINE 

160 RETURN 

60 REM - RESTART OR END PROGRAM? 

70 INPUT "MORE DATA (IsIES*, OsNO)? "$1;N 

80 IF N<>0 THEN GOTO 20 

90 STOP 



A RETURN statement must not be encountered unless a GOSUB statement 
has been e:cecute<i. 

"Remembering" all the return points by saving them on the GOSUB stack 
and never removing them can exhaust the available GOSUB stack area. 
The. following- program, which calculates N! illustrates this problem. 
Its use requires that N return points be remembered. 



10 


INPUT "Na ";N 


20 


GOSUB 100 


30 


PRINT N,N1 


40 


STOP 


100 


N3sN 


110 


N2s0 


120 


Nisi 


130 


GOTO 160 


140 


N3=N3-1 


150 


GOSUB 160 


160 


IF N3>1 THEN GOTO 140 


170 


N2=N2+1 


180 


H1aN1«N2 


190 


RETURN 



^.ifflfflSRftv 



The POP statement removes the top most previous return address from 
the GOSUB stack. It does not perform a return transfer to the calling 
routines. Execution continues at. the statement following the POP 
statement in the internal subroutine. The POP statement is useful for 
exiting nested subroutines as the following example demonstrates. 
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10 REM - MAIN PROGRAM 

20 GOSUB 100 ! CALL GET DATA 

^W « e e e e 



100 REM . I SUBROUTINE GET DATA 
110 GOSUB 200 ! CALL GET NUMBER 



120 



190 GOTO 100 ! GET NEXT DATA SEQUENCE 
200 REM - SUBROUTINE GET NUMBER 



c e « G • 



250 REM - NUMBER- FOUND? 

f^n EJ^ ^^^^ ^^^N I IF NUMBER - RETURN 
270 REM - NO MORE NUMBERS ntiuiiw 

290 StUR^ ™°^ "°^^ ^^^ ^™ ^^^^S 

la this example, the Bain program calls subroutine 100 whi^h .• 
/*s ' ■--' ^^^^ subroutine 200 until there ^a no m«^^,i:« ^ ^ °^ ^ 

r-.m tjjits With a RETURN when d^ns-foS^/l^ f POP t^^^^ 

there is ae moro data. Program execution tSn ^^ues^t SS 

5-.6.4 ON STATEMENT 



/<7ariable>"^ (goto'*! 

[line number] 0N< JtHEN^ ) <liae number> , Cine number 

(<expression^ |gosub( - 
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The ON statements select the target transfer line number of a GOTO or 
a GOSUB from a list of statement numbers. The statement number list 

contains a statement number- for- each expected value of the expression 
or variable. The selection is based on the value of the expression or 
variable truncated, to an integer; If the expression value is 1, the 
first line number in the list is selected. If the value is 2, the 
second will be executed, and so forth* The GOTO or- GOSUB statement 
will be executed transferring control to that line. If the expresson' 
value is less than one or greater than the number- of statement numbers 
in the list, the transfer is not made and execution simply continues 
with the next statement c 

Examples : 

10 ON J*1 THEN GOTO 15, 20, 35^ 46, 70 ' 



When J is equal to 3, J+1 is equal to 4 and control is transferred to 
the fourth statement number- (46). Similarly, J values of 0, 1, 2, and 
4 result in jumps to statement numbers 15, .20, 35, and 70, 
respectively. 

110 ON X+3 THEN GOSUB 20, 40, 80, 300 
120 ON (A+5)/Z THm GOTO 10, 30 

When X is equal to -1, the second statement number (40) is executed 
next. When X is. less than -2 or greater than +1, a transfer is not 
made and line 120 will be the next statement executed. When (A+5)/Z 
is equal to 2, the second statement number (30) is executed next and 
so forth. If the expression evaluates to a non-integer- value, only 
the integer- part is used to determine the appropriate branch point. 

5.6.5 FOH/NEXT LOOPS 

FOR and NEXT statements indicate the start and end of an instruction 
block that is to be repeatedly executed as a set. One variable takes 
on different values within a specified range; this variable is often 
used in the computation or evaluation contained in the instruction 
block. The FOR statement names the variable and stepping values of 
that variable and also specifies its initial and final values. The 
NEXT statement closes the program loop. 

The FOR statement may have either- of the following forms: 

jJLine number^ FOR <variable>s<expression>TO<expression> 

gLine number] FOR •cvariable>s<6xpression>T0<expression>STEP<expression> 



yftH^fcV 
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■where 

variable is a simple numeric scalar variable 
sspression is a valid POWER BASIC numeric expression 

The NEXT statement has the foias 

&ine number] NEXT •<variable> 

vihere 

variable is a simple numeric variable 

r- ■ ISteSSi* J^=S^® f i^^^P statement must be the same as the FOR 

f statement variable at the beginning of the loop. 

Specification of the STEP value is optional and usually omitted. If 
omitted, a value of+l is used. The step value may be any constant 
^luf''^J^■M'''"/"^"^'°^ evaluates to a posiWveTr 'ne?at?v4 
Se F0« 1T2^^^ ^^^^ intenrals can be used to decrease the value of 
the FOR variable from one pass through the loop to the next. By using 
a step value of -1, the FOR variable can be made to decrease by 
integer values during successive loop interactions . 

2L l^t^^u-^^'f example illustrates the FOR and NEXT statements. 
Note that this is not a meaningful POWER BASIC program. 

100 FOR XsO TO 3 STEP D 
200 NEXT X 

400 Sr^X4^^'^*^°^^^^^^^ ^° 3»SQR(10) STEP 1/4 

^ 500 FOR Xr8 TO 3 STEP -1 

600 FOR Js-3 TO 12 STEP 2 

TOO NEXT J 

800 NEXT X 

Note that the step size may be a variable (D), an expression (1/4) a 

?I^'slori«\'i;l^' ''^ ^°f ''"^ """"^^ ^2^- ^ the example wit^ 
lines 300 and 400-, successive values of X4 will be .25 aoart in 

^l?Vtl T^f- i^f^ °!^* ^^^»P1«' *^« successive vllues of^ 

wiii &e 8, 7, 6, 5, 4, and 3. In the last example, on successive 

• f ®^f °f ^"'"S^ the loop, J will take on values -3, -I, 1,3, T 7? 

• Slues^'^hev^wfii^?. ""^^f to specify the initial, final or step-size 
Sin//«. ^ ^^.xf ^'^'^ted only once when the FOR loop is entered, 
caianging any of the values of the FOR loop (either- the step, initial 
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or final values) within the FOR loop does not affect the number of 
times the sequence is executed except for the control variable. The 
control variable is assigned to the initial values when the FOR 
statement is entered and is incremented (if the STEP value is 
positive), r- dec remented (if the step value is negative) after- each 
repetition of the loop sequence. The last repetition of the loop 
sequence, is when the control variable is equal to the final value. 
When exiting the loop in this manner, the control variable is 
incremented (or- dec remented) one step value beyond the final value. 

A p re-cheek is performed so that if the initial value is greater than 
the final value in the case of positive STEP values, the loop sequence 
will not be executed. Likewise, if the initial value is less than the 
final value and the STEP value is negative, the 'loop sequence will not 
be executed. ,.mm. 

The control variable may be changed within the body of the loop and . 
the latest value of the variable will be used in the exit test; 
however; this programming practice is not recommended. 

The statement "50 FOR 1=2 TO -1" without a negative . step size results 
in the body of the loop not being executed and execution proceeds to 
the statement immediately following the corresponding NEXT statement. 
The NEXT statement must be the first item in a line for this feature 
to work properly. 

The loop continues to be executed as long as the condition: 

(step value)»( control variable)<(step value)»(end value) 

remains true. If the condition: 

(step value)* (start value )>( step value)* (end value) 

is true when the FOR statement is first encountered, the loop will not 
be executed. 

When the loop is being executed, the control variable is first set to 
the initial value and if the end criterion is not true, the loop is 
executed. The control variable is then incremented by the step value 
each time the NEXT statement is encountered and executed. The loop 
terminates with the control variable equal to the last value used in 
the loop plus the step value. 

Example: • 

10 FOR Isl TO 4 STEP 2 



y*B«**\ 
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80 NEXT I 

90 PRINT "Is";! 

RUN 

Is 5 

The NEXT statement closes the FOR loop. When it is encountered the 
step value is added to the control variable. If the control variable 
has not gone beyond the end value, control will be returned to the 
fii^st stateaent following the FOR which opened the loop. The control 
variable of the loop to be closed must be specified by the NEXT 
statement. It is possible to place the FOR and NEXT statements on the 
same statement line; however; remember- that statement lines are 
autonomous. Therefore, this type of loop structure cannot be 
interrupted by using the escape key since keyboard sampling is 
ps performed only between statement lines. 

Also, FOR/NEXT statements on a single line or- in separate statement 
lines will cause an error to result if, during the initial p re-check, 
the initial value has exceeded the final value. For- example, 

20 FOR IslO TO 1j:NEXT I 

will result in a FOR W/0 NEXT error- (ERR=31). 

FOR loops may be nested; i.e., one FOR loop may contain another which 
may contain a third, etc. If nested, howeveri they should not use the 
same control variable. When two loops are nested, one must be 
completely contained within the other. Overlapping is not permitted. 
The following stracture is correct; 

10 FOR Isl TO 2 
20 FOR Jsl TO 2 

<f*^ 30 FOR Ksl .TO 2 

e 
e- 

80 NEXT K 
90 NEXT J 
100 NEXT I 

while the next two structures are incorrect: 

10 FOR Isl TO 2 
20 FOR Jsl TO 2 

o 

o 
e • 

80 NEXT I 

90. NEXT J (WRONG, loops may not overlap) 

10 FOR Isl TO 2 
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20 



FOB Isl TO 2 



80 NEXT I 
90 NEXT I 



(WRONG, nested loops may not have the same 
control variable.) 



The following program illustrates nesting; 

LIST 

TO REM AREA OF A TRIANGLE 

20 FOR B=6 TO 9 

30 FOR Hsil TO 13 STEP 0.5 

49 AsB»H/2 

' '50 PRINT B,H,A 

60 NEXT H 

70 NEXT B 

80 STOP 



! FIRST LEVEL OF NESTING 
I SECOND LEVEL OF NESTING 
ISECOND LEVEL OF NESTING 
! FIRST LEVEL OF NESTING 



y<((S^^V 



This program prints the base, height, and area of triangles with bases 
6-, 7, 8 and 9, and heights 11, 11.5, 12, 12.5, and 13. All 
eoffibinations are printed: 20 sets of data for- the fourbases and five 
height values. 

All values of the variable in the inner loop are cycled through while 
the variable in the outer loop is set to its first value. The outer 
loop variable is then set to its second value and the inner loop is 
cycled through again. The program runs through each outer loop value 
this way. 

Nesting of FOR/NEXT loops is permitted to a level of 10 in 
Configurable BASIC. 

It is legal to transfer" control from within a loop to a statement 
outside the loop, but it is never- advisable to transfer control into a 
loop from outside. The next two examples Ulustrate both of these 
situations . 

Valid transfer -out of a loop: 

20 FOR 1=1 TO N 

30 XsX+2*I 

40 IF X>1000 THEN GOTO 100 

50 NEXT I 

Invalid transfer • into a loop: 

20 GOTO 50 

30 FOR Isl TO N 
40 XsX»2»I 
50 YsI+X/2 
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60 NEXT I 

. V (WRONG, 50 is inside a loop) 

However-, tt is permissable to call a subroutine from within a loop and 
then return from the subroutine back into the loop. The following 
example illustrates repetitive calling of a subroutine from inside a 
loop. 

Example: 



/•'■'^^WBiv 



10 
20 
30 
40 
50 
• 


FOR Isl TO N 
Xs2«I-1 
GOSUB 150 
2=Z+I 

NEXT I 


>. 

150 IF X012 THEN GOTO 
160 1=248 
170 RETURN 
180 Is200+4»X 
190 RETURN 



180 



r 



5.6.6 ERROR STATEMENT 

The ERROR statement specifies a subroutine that will be called 
whenever any POWER BASIC error occurs. 

Fomj 

[lin^ number ERROR <line number> 



The ERROR statement enables the user to trap to an internal error 
processing subroutine on the occurrence of any error encountered 
during progiam execution. When an ERROR statement has been executed 
and an error occurs, internal control passes to the specified line 
number via a GOSUB statement. The statement number which contains the 
error- is placed on top of the GOSUB stack. If the error is 
recoverable, a RETURN statement will resume execution at the statement 
following the error when it has been corrected. If the error is 
unrecoverable and control will not be transferred back via a RETURN, 
it is good programming practice to execute a POP statement to remove 
the line number from the top of the stack. This practice avoids 
unnecessary -cluttering of the stack, which may cause unpre- 
dictable results. After the error trap, the system function 
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SYS(I) will contain the error code number and SYS (2) will contain the 
statement number in which the error occurred. The error codes and 
corresponding error messages are presented in Appendix A-1. These are 
necessary for- processing in the error handler subroutine. 

Once an error is encountered and causes transfer- to the error handler 
subroutine, the ERROR statement flag is cleared and future errors will 
not be trapped unless an ERROR statement is again executed. When an 
ERROR statement has been executed and an error occurs, the automatic 
printing of the error- code is supprsssed. 

The ERROR statement is- particularly valuable when developing an 
application program which is to be configured into a Target POWER 
BASIC Interpreter- and application for execution in a TM990 board 
system. The ERROR statement is almost required to process errors 
generated during program execution, since the Target POWER BASIC "^ 
Interpreter consequently does not have inherent error- reporting 
capability, and all errors are consequently fatal errors, and program- 
execution will stop when an error is encountered. The ERROR statement 
may enable many of errors to be recoverable instead of fatal. 

Example: 

10 ERROR 1000 !SET ERROR ROUTINE 

20 DIM E(2,2) 

30 INPUT A,B,C 

40 Dfe((A«B)+C)/B 

50 E(A,B)=0 

60 F=SQR(C)+LOG(A+C) 

70 PRINT A;B;C;D;E(A,B);F 

80 GOTO 30 

1000 PRINT "ERROR =";SYS(1), "LINEs •';SYS(2) '^ 

1010 IF SIS (1)s28 THEN PRINT "DIVISION BY ZERO":: GOTO 1070 

1020 IF SIS(1)=17 THEN PRINT "SUBSCRIPT OUT OF RANGE":: GOTO 1070 

1030 IF SIS(1)=25 THEN PRINT "SQUARE ROOT OF NEGATIVE NUMBER:: GOTO 1070 

1040 IF SIS(1)=26 THEN PRINT "LOG OF NON-POSITIVE NUMBER": : GOTO 1070 

1 050 PRINT "FATAL ERROR" : :POP 

1060 STOP 

1070 PRINT "INPUT VALUES AGAIN" 

1080 ERROR 1000 ! RESET ERROR ROUTINE FLAG 

1090 POP 

1100 GOTO 30 

Statement 10 designates the subroutine, starting at statement 1000, to 
be the ermr handling subroutine. When any emr occurs, control is 
transferred to statement 1000, and- first the error- number and line 
number are displayed on the terminal device. Next the errrar number is 
tested for various types of arithmetic- erroria. If the error number is 
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found, an appropriate error message is output, the ERROR flag is 
reset, -and the values are asked to be input once again. If the. error 
nufflber cannot be found, the POWER BASIC program will stop. 

5.6.7 STOP STATEMENT 

The STOP statement terminates program execution at the logical end of 
the program. There may be one or more STOP statements in a POWER 
BASIC progzam. They may appear anywhere within the prsgram. 

Forms 

&lne numbe^ STOP 

When the STOP statement is executed, the system displays the line 
f*^- where progzam execution terminated. 

Example: 

900 STOP 

RUN 

STOP AT 900 

5.6.8 END STATEMENT 

The END statement marics the end of a progimm and tenainates program 
execution. 

Fom; 

pdne numbe^ END 



END statement functions just as the STOP statement. It may appear 
as any statement within the program. When executed, the system 
displays the statement number where program execution terminated. 

Examples 

70 END 

RUN 

STOP AT 70 



5. 6. -9 BTB STATEMENT 



The BIE statement, when executed, terminates POWER BASIC and rstums 
control to the TX990 operating system. During this process all files 
are closed, and all Logical Unit Numbers (LUNO's) are released. 
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Form; 

&ine nufflbe^ BYE 
Examples : ; 

1000 PRINT "JOB DONE" 
1005 BYE 

5-. 7. INTERNAL INPUT STATEMENTS i 

READ, DATA and RESTOR statements are used in the following fonns: 

-, . /<humeric variable^ /<numeric variable>\ • 

CLin« numbef] READ \<string variable> ) , • \<string variable> J , . . . 

r,, ^ . /<expr8ssion> n f<exp ression> "n 

[line numbe^ DATA (<3tring variable) I , I <string vartabl^. I , ... 

is.<string constant^ lv.<string constan^J 

Cline numbe^ RESTOR 

(line number} RESTOR <lin€ number> 

(line numbe^ RESTOR #<simple numeric variable) 

POWER BASIC penaits definition of a list of data items containing both 
strings and numbers within the program. Entries in this list are 
defined by -DATA statements and accessed sequentially by READ 
statements. The RESTOR statement is used to move to a specific point 
within the list or to the beginning of the Ust. The RESTOR # variable 
statement will rewind the specified device/ file, 

5.7.1 DATA STATEMENT 

The DATA statement contains a list of data items separated by conmias. 
Each item in the list is either a string constant or an expression 
which evaluates to a numeric constant. String constants must be 
enclosed in quotes. 

Example: 

10 DATA 5,3. 14459, "DOE, JOHN" , 4*ATN( 1 ) 

A program may contain any number of DATA statements with nd 
restriction on their placement within the prsgram; however, they arei 
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typically placed together in a data block near the beginning or end of 
the program. The data list will contain all of the data items from all 
DATA statements in the same order they are written in the program. 
DATA statements have no effect when encountered during execution. 



5-. 7. 2 BEAD STATEJffiNT 



The READ statement assigns values from the internal data list to 
variables or array elements. The first READ statement executed 
normally starts with the first item in the data list. Reading of data 
items continues sequentially unless a RESTOR statement is executed. An 
.error (READ OUT OF DATA AT XXXX) is generated when a READ statement 
requests the next value with the data block exhausted of data. 

The READ statement specifies a list of variables or array elements 
^ose values are to be assigned from the data list as shown below: 

^ 50 READ X, I, A(5,X), $B,$C(Y) 

The following examples illustrate use of the DATA and READ statements: 

10 READ A,B,C,D 

20 H=A*B»C*D 

30 PRINT A,B,C,D,H 

40 READ E,F,G 

50 HsE*F«G 

60 PRINT E,F,G,H 

70 DATA 2,3,5,7,11,13,17 

80 STOP 

RUN 

2 3 5 '7 210 

11 13 17 2M31 

The data in this example is supplied in one DATA statement, but is 
used at two different locations in the program in two READ statements. 
When the program encounters the first READ statement, it searches for 
the lowest-numbered DATA statement (which may occur before or after 
the READ statement) . The program takes numeric values ft*om the DATA 
statement in sequence associating them with READ statement variables 
in sequence. In the example, A is assigned the value 2, B the value 
3, C the value 5, and D the value 7. The program establishes access 
to the next data value (11), so it may be assigned to the first 
variable encountered in the next READ statement. Line 20 is computed, 
and the newly-introduced variable H is assigned its computed value. 
The next READ statement at line 40 introduces three new variables. The 
statement continues to supply data from line 70 at the 
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pre-established access point, so the new variables E, F, and G take on 
the values 11, 13, and 17. A new value for H is conputed in line 50. 
The statement that follows prints the new values for E, F, G, and H. 

The user must match numeric variables in the READ list to numeric 
expressions in the data list. Similarly, the user must match string 
variables in the READ list to string constants or string variables in 
the data list. An error will result if this convention is not 
followed. 



10 READ A,B,$CAT 

20 LET CsA+B 

30 PRINT A,B,C,$CAT 

40 DATA 2,3, "TEXT" _ 

50 STOP ■ 

RUN 

2 3 5 TEXT 

•5.7.3 RESTOR STATEMENT 

The RESTOR statement allows more than one READ statement to access 
DATA statements. The RESTOR statement is used to move to a specific 
point in the Internal DATA list or to the beginning of the Ust. A 
"RESTOR #<variat>le>" statement is used to rewind the specified 
file/device to its beginning. 

A RESTOR statement without an argument resets the pointer to the 
beginning of the first DATA statement, A RESTOR with an argument resets 
the pointer to the line number specified. The line number specified 
must exist but need not be the line number of a DATA statement. The 
next sequential DATA statement will be used. 

Example: 

70 RESTOR (restores to the beginning of the data list) 
80 RESTOR 20 (restores to the first DATA statement at or beyond 
line 20) 

The following example program illustrates the use of RESTOR: 

10 DATA 14,16,18 

20 READ I,J,K 

30 PRINT I,J,K 

40 RESTOR 

50 READ X,r,Z 

60 PRINT X,I,Z 

70 END 

RUN 

14 16 18 

14 16 18 
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The RESTOR statecsent in this program resets the DATA pointer and 
transfers control to the READ statement in line 50 which then obtains 
data from line 10 (even though the READ statement in line 20 has used 
the same data). If the RESTOR statement was omitted ,- POWER BASIC 
would print an error message indicating a lack of data for the 
variables in the READ statement at line 50. 

If the following statement is added to the example program between 
lines 40 and 50; 

45 DATA 2,24,26 

The statement at line 50 would still cause the values 14, 16, and 18 
to be printed. The RESTOR statement at line 40 results in data being 
ebtaiafed from' line 10 rather than from" line 45. 

f^ If a program has no DATA or READ statements, the use of the RESTOR 
statement does not affect the program. 

The "RESTOR #<variable>" statement will rewind the file assigned to 
the specified variable. The variable contains the Logical Unit Number 
(LONG) assigned to a particular file. The variable is assigned the 
LUNO value when the file is opened by the BOPEN' statement. The 
associated file/device will be rewound to its beginning. The file 
must be opened before the rewind may be performed. 

When the device specified is the 733ASR cassette unit, the RESTOR 
statement rewinds the cassette tape to the clear area at the beginning 
of the tape and then .moves the tape in the forward direction to the 
begining of tape marker, illuminating the READT indicator on the 
733ASR. When the specified device is the line printer, the RESTOR 
statement performs a form feed operation. Performing a RESTOR on a 
diskette file stimulates the rewinding of the diskette file, causing 
the ne%t read or write operation performed on the file to access the 
^' first record in the file. After a sequential file has been opened and 

record written to it, the file cannot be rewound until the file is 
closed via the BCLOSE or RESET statement. When the file is a relative 
record file, the relative record position is set to zero. The RESTOR 
operation is ignored by all other devices. 

Example: 

10 REM 
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40 BOPEN '^CSl'*, I ! OPEN CASSETTE AND ASSIGN LUNG 

50 BOPEN "DSC2PR0G/DEV",J ! OPEN DISKETTE FILE AND ASSIGN LONG 



110 • RESTOR #1 I REWIND CASSETTE FILE 



170 RESTOR #J ! REWIND DISKETTE FILE 

Target POWER BASIC Interpreter: The form ^RESTOR #<variable> " is not 
supported by the POWER BASIC Configurator, therefore the "RESTOR # 
^ariable>''* statement should not be presented in a final application 
which is to be configured into a customised (Target) POWER BASIC 
Interpreter. 

5-8 TERMINAL I/O STATEMENTS 

Terminal I/O Statements consist of an INPUT statement to allow 
keyboard input from a terminal and a PRINT statement which. prints 
values of expressions in an output list on the output device. 

5o8.1 INPUT STATEMENT 

The INPUT statement is used for keyboard input from an interactive 
terminal into variables of the BASIC program. 



Forms 



5in, n^Mberl ISPOT <variabl,> g <.az.Uble> (f 



The INPUT statement performs as a READ statement with the exception 
that it accesses the ntmeric constants and strings from the external 
keyboard instead of from internal DATA statements. It provides all 
translation from character data to the internal formats of the POWER 
BASIC system and thus assigns input values to the variables or array 
elements specified in the input list. All characters are echoed as 
they are entered. The INPUT statement is extremely versatile and 
provides a means to 1) input numbers only, 2) input character strings, 
•3) detect control characters, 4) prompt with character strings, 5) 
specify maximum number of input characters, 6) specify exact number of 
input characters, 7) suppress carriage return/line feed, and 8) 
suppress prompting. 
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Input variables may be entered in a list separated by carriage 
returns. Numeric data may be represented as decimal integers, 

floating point, exponential, or hexadecimal values. There should be 

no embedded spaces within numeric values and all spaces preceding or 

following numeric data are ignored. For string data input, the string 

consists of all characters after the prompting character- and up to but 

not including the end of the input (carriage retuni). The string 

includes aU entered blanks and quotes. 

The INPUT statement prompts the user with a question mark (?) for 
numeric only inputs and a colon (:) for character inputs. If an 
incoirect key is entered during input, and the terminating carriage 
rettum has not yet been entered, the RDBOUT or DEL CHAR key may be 
*used to appropriately backspace the cureor*and delete the offending 
characte r(s). The correct response may then be entered. If an 
illegal numeric input is entered (with a carriage return) in response 
to the question mark prompt, the computer will respond with a double 
question mar^ (??) and wait for- correct input. The computer will 
continue to prompt until the user has entered all data requested. 

In the following examples, a carriage return is represented by 
(6S), and all user responses are underlined. 



Examples: 


• 40 


INPUT X - 


50 


INPUT $A, 


60 


INPUT $I,Z 


70 


PRINT X, $. 


80 


STOP 



$B 



RUN 
?256 (er) 

•.CAT (er) ; DOG (er) 
•SI (cr) ?80A (Grr ??80 (cr) 
25^ CAT DOG HI 80 

STOP AT 80 

In the program statement 40 outputs a question marie waiting for 
numeric input. The user entered the number "SSS" followed by a 
carriage return which terminated the INPUT statement of line 40-. The 
variable X is assigned the value of "256." Next it prompts with a 
colon awaiting character string input. The user enters "CAT" followed 
by a carriage return. The computer immediately prompts with a colon 
awaiting the next string input. The user enters "DOG" and a carriage 
return which terminates this input line. The computer then prompts 
with a colon and the user inputs "HI" and a carriage return. Next, the 
computer prompts with a question mark and the user incorrectly enters 
"80A", an illegal nximeric value. Therefore, the computer responds 
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with a double question marie and awaits correct input. The user enters 
"80" followed by a carriage return which terminates the INPUT 
statement. Statement 70 is then executed and outputs the values read 
into the variables.- 

An INPUT statement caii be combined with a PRINT statement to prompt 
user response as follows: 

20 PRINT "lOUR VALUES OF X, Y, AND Z ARE"; 
30 INPUT X, I, 2 '" 
40 STOP ; 

RUN 
- lOUR VALUES OF X, I, AND Z ARE? 50 (or) ?60 .(cr) ?70 (cr) 

STOP AT 40 

Since user- prompting for. data input is required in most applications,' 
the INPUT statement has been designed to permit string constants to be 
embedded in the INPUT statement for direct prompting output. The 
string constants must be enclosed by quotation marks. TherB may be any 
number of string constants within the INPUT statement separated ft-om 
input variables and oths' string constants by commas or semicolons. 

The above example may be performed as follows: 

20 INPUT "TOUR VALUE OF X IS",X, "I", I, " 2". 2 
30 STOP 

RUN 
lOUH VALUE OF X IS? 2 (cr) Y? 2 (cr) 2? 3 (cr) 

STOP AT 30 

Similarly for- string input: 

10 DIM N(5) 

20 INPUT "\JHAT IS lOUR NAME", $N(0) 

30 PRINT "TOUR NAME IS "j$N(0) 

40 GOTO 20 

RUN 

WHAT IS lOUR NAME: JOHN (cr) 
TOUR NAME IS JOHN 
WHAT IS TOUR NAME: 

A semicolon may be used to perform input formatting. If a semicolon 
is placed af the end qfan INPUT statement line, the carriage 
return/line feed is supprsjssed afte r- p recessing the INPUT' statement as 
the example below illustrates: 



^^^i^pflffl^^y 
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10 INPUT "INPUT X", X: 

20 PRINT " X SQUAREDs"; X»X 

30 INPUT "INPUT y, r 

^0 PRINT "I CUBED=": r*Y»Y 
50 STOP , ^ J. 1 

RUN 

INPUT X?J2 (cr) X SQUAREDs 144 
INPUT ITTCotT 
r CUBEDs""27~" 

STOP AT 50 

th. constant 1?7o toat "x^QwIm!*', A'n ""P™"'* »f " r- e: 
llns. In line 5n a ,.»<„.? , "* °*° '^ »>"P«t o" t 

Whea the semicolon is nlaeed b^f « «* ^•^ -. ^ 

INPUT li^t, the autonii^ic' p ^npting ?f a auesSr' L^"^''' 
suppressed. The user-may then nar5««! »,. question. mark or cc 
BASIC ProgiHiB by Isinf phtS? «f^ ™.^^^ ^"^ prompting in the 
in the INP^sSte^^^ ^^^^ statements or placing cha:^cter ^ 

Eseample : 

5 DIM N(3) . 
10 ^UT "WHAT IS YOUR EMPLOYEE NUMBER''" iN(0) ■ 
20 INPUT "WHAT IS YOUR EMPLOYEE NuSg?"! In(0) 

RUN 

mLT IS YOUR EMPLOYEE NUMBER?: 1234 (cr) 
WHAT IS YOUR EMPLOYEE NUMBER? 1 2 3r"(i7r 

STOP AT 30 
?o pISpt'wJ'LS ''"'^* ^""^''^ ""^ - «i«n ( = >• I» ^ 

S.S.t.l SPEKFICAHOH OH HDMBES OF mm CHABACTSHS . 

from the keyboa^^^Tll^ofThr.°^ character which can be en 
eyooara. Use of the % operator will specify the 
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number of characters whieh must be entered. The scope of both the 
# and $ operators extend through the entire INPUT line. 

Forms? 

Dine numbe^ INPUT # <expression> Q <variable> Q ... 

(iiae number) INPUT % <expression> Q </ariabl^ Q ... 

When using the # operator, the user nay enter any number of characters 
less than the specified maximum by ending the input sequence with a 
carriage return. The user cannot enter more than the specified 
maximum number. When the maximum number of characters have been 
entered POWEH BASIC stops accepting keyboard input, assigns the value 
^st entered, and automaticJally continues to the next sequential 
statement or INPUT statement parameter. 

Use of the % operator requires that an exact number of characters be 
entered. POWER BASIC waits for the exact number of specified 
characters to be entered and then continues to the next sequential 
statement or INPUT statement parameter; no carriage return (cr) is 
required at the end of user INPUT. If the user attempts to enter less 
than the specified number of characters by ending the inout sequence 
with a carriage return, POWER BASIC will ignore the carriage return 
and continue to wait until the number of characters specified have 
been entered. 

Examples : 

10 REM THE MAXIMUM NUMBER WHICH CAN BE ENTERED IS 990 
20 INPUT #3, A, B 
30 STOP 

RUN 
?512 ?900 

STOP AT 30 

10 • PRINT "ENTER PHONE NUMBER (XXX-XXX-XTCX) "; 
20 INPUT $3, -A,"-" JB,"-", $4 J C 
30 $A1=As:$B1sB::$C1=C 

40 PRINT "YOUR PHONE NUMBER IS": Mil"-" l^BI;"-": iCI 
50 STOP 

RUN 

ENTER PHONE NUMBER (XXX-XXX-XXXX) 123-456 -1234 
rOUR PHONE NUMBER IS 123-456-1234 

STOP AT 50 
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Is the first example the user may enter any numbers which do not 
require more than three keystrokes. The range would be limited to -99 
t© 999. In the second example the user is requested to enter his 
telephone number in the format XXX-XXX-XXXX . The % symbols require 
the user to enter exactly the required amount of nximbers. The user 
enters 123. The computer places the number in variable A and outputs 
a "-". The user enters 456, and the computer places the number in 
variable B and outputs a «-•». The user enters 1234 to complete the 
sequence. Statement 30 converts the numeric inputs into strings and 
places them into $A1, $B1, and $C1 . Statement 40 then prints the 
user's phone number using these string variables of the INPUT list. 

5.8.1.2 INVALID INPUT CHARACTER PROCESSING 

^■. . The user may detect any invalid input or control characters which are 
' entered dta'ing both numeric and string variable assignment by using 
the question mark (?) operator in the input list. 

Forms 

[Une numbe:5 ^NP^ ? ■dine numben^j <variable> (y . . . • 

The "?" operator specifies the line number to which control is 
-transferred via an internal GOSUB statement if a control character or 
invalid input is encountered during input. The' scope of the "?" 
operator extends through the current INPUT statement only. Execution 
of the next INPUT statement without the "?" operator resets the 
invalid input function. The SIS(O) function will return the control 
character encountered. SYS(O) will be equal to -1 if there was an 
invalid input. Otherwise, SYS(O) will equal the decimal equivalent of 
the control character. This feature is useful for transferring 
control to internal subroutines by using the INPUT statement. 
^ Executing a RETURN statement in the subroutine will result in a return 

to the statement immediately forllowing the INPUT statement. For 
example; a (control) H can be used to transfer to a routine which 
outputs a HELP message sequence for the user who requires additional 
information for the input of data. 

Example: 

10 PRINT ^INPUT VALUE "j 

20 INPUT ?100,N 

30 PRINT "NUMBER IS^jN, "IT'S SQUARE ROOT IS "; SQR(N) 



90 GOTO. 10 

100 IF SIS(0)s-1 THEN PRINT:; PRINT "NUMERIC INPUT ONLY" :: RETURN 
110 REM IF (CNTL) H GOTO HELP ROUTINE 



S-35 



120 IF SYS (0)s8 THEN GOSUB 200:: RETURN 

130 REM IF (CTRL) G GOTO BACKSPACE TO PREVIOUS INPUT ROUTINE 

no IF SIS(0)s7 THEN GOSUB 300: : POP: : GOTO 10 



180 POP 
190 RETURN 



200 am HELP ROUTINE— 

210 PRINT 

220 PRINT 

230 PRINT "USER INPUT ASSISTANCE" 



290 RETURN -^ 

Statement 20 specifies line number 100 as the entry point to the ■ 
invalid input processing routine. When as invalid input occurs (in 
this case either a control character or non-numeric character), 
control is transferred to statement 100. It is. first tested for 
invalid (non-numeric) input. If this is found to be true, it outputs 
the message and returns. If it is not an invalid character input, it 
is then tested for a Control H (08) or HELP input character. If a 
control H was input, the GOSUB routine -may display a help menu to 
inform the user of all valid inputs and their functions. If not a 
control H character, then SYS(O) can be further tested for other 
special function control characters as defined by the user, such as 
back up to previous input, erase current input, or stop program 
execution. 



5-. 8. 1.3 INPUT STATEMENT CURSOR CONTROL 

The user may perform screen positioning to any location of the 911VDT 
or 913VDT terminals before performing the specified numeric or 
string variable input assignment by using the g operator in the input 
list. The § operator is supported only by the Host POWER BASIC 
Interpreter on the FS990 computer. 

Forms : 

[line number] INPUT g(<exp1>, <exp2» {;}<variable>{;} 

(line number] INPUT §<$VAR> {;} <variable>{;}.. . 

Cursor control via the § operator may appear numerous times and at any 
position within the INPUT list. It appropriately positions the cursor 
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_ before perforaing the INPUT variable assignment. The INPUT and PRINT 

- statements both support an identical set of cursor positioning 

commands. For a complete explanation of the cursor positioning 

capabilities of POWER BASIC, refer to paragraph 5. 8. 2. 3, PRINT 

STATEMENT CURSOR CONTROL. 

Examples: 

10 INPUT §(0,20^jI,§(5,50),J,K 

20 INPUT §"C5D10R";$A 

30 INPUT §"C'',A1-,§(10,10->jB1 

Taiiet POWER BASIC Interpreter: INPUT Statement Cursor Control is not 
supported by the POWER BASIC Configurator, therefore cursor control 
should not be present in a final application program to be configured 
into a customized (Tatiget) POWER BASIC Interpreter. 

5.8.2 PRINT STATEMENT 

The PRINT statement causes the values of all expressions in the list 
to be printed on the output terminal. Commas and semicolons are used 
to separate expressions and provide for print formatting. 

Form: 

[line number] S ; ) <expression> (',? <expr8ssioil> l;\ ... I;\ 

The expression list may contain any numeric variable, numeric 
expression, strii^g variable, string constant, or any ASCII code which 
is to be output to the terminal device. 

Sfe'ing constants may be printed directly by inserting them in the 
PRINT statement expression list. String variables are printed by 
having the variable name preceded with the dollar sign designator. 
The following example illustrates the output of string constants and 
sts'ing variables. 

100 DIMN(IO) 

110 $N(0)s "POWER BASIC." 

120 PRINT "THE NAME OF THE LANGUAGE IS "; 

130 PRINT $N(0) 

140 STOP 

RUN 

THE NAME OF THE LANGUAGE IS POWER BASIC. 

STOP AT 140 



5«37 



The PRINT statement may be used to directly output ASCII, codes to the^ 
terminal device* The hexadecimal ASCII code must be enclosed in angle! 
brackets, (e.g., <0A> ) and may be placed anywhere with string - 
constants or-predefined string variables appearing within the PRINT 
statement expression list. Only the low order- seven bits of the 
hexadecimal code will be output to the device • 

Example: 

10 PRINT "GO TO THE NEXT LINE <OA><pD> AND CONTINUE PRINTING!" 
would geneate 

GOTO THE NE2T LINE 
' AND CONTINUE PRINTING 

In a similar- manner, any ASCII character can be placed into a string 
variable with the use of the replacement ($) operator. The $ operator 
places the single byte value of the succeeding expression into the 
specified character string. The expression represents the decimal or 
hexadecimal ASCII representation of the byte value to be placed in the 
string (eogc, $As$0AH?0DHjOH) . String variable assignment using byte 
value insertion, should always be terminated with a null '(zero byte) 
insertion (e.g., J0AH?041H50H) • While actual character insertion into 
an existing string would typically not be terminated with a null 
insertion (e.g. ,. $A(0;4)s5S45,J4l). ASCII codes may be cohcatented to 
character" strings, however- character strings may not be concatenated 
to ASCII codes in character assignments. For example, $As$B + "YES" + 
510J13 is a valid character assignment, while $As$B + J10J13 + ''NO" is 
an illegal character assignment. These string variables can then be 
output with the PRINT statement. The following example program 
illustrates this procedure. 

.Example: 

List 
10 DIM Ado) 

20 $Bs$10?13?0 !(10=LINE FEED, 13= CARRIAGE RETURN) 
30 $A(0)s"GO TO THE NEXT LINE "+B+'' AND CONTINUE PRINTING!" 
40 PRINT $A(0) 
50 STOP 

would generate, 

GO TO THE NEXT LINE 
AND CONTINUE PRINTING! 

To facilitate- rapid statement entry in the edit mode, a semicolon (;) 
may be used in place of the word "PRINT" in any PRINT statement. Upon 
statement entry, the semicolon is internally translated to the "PRINT" 
code. Thereafter, listing of the statement will result in output of 
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the word "PRINT." For exafflple" 

10 PHINT I, J 

20 ;X,X,Z 

30 ? 'THE SEMICOLON WILL LIST AS "PmNT"' 

LIST 

10 PRINT I, J 

10 PRINT X,Y,2 

30 PRINT 'THE SEMICOLON WILL LIST AS "PRINT"' 

Ifl its simplest form, the expressiens in the output list are separated 
by-coaffias. In this fona, an output line is divided into five 
15-chaiacter- print fields starting ia columhs t, 16-, 31, etc. A conma 
^ folleiwing an expression in a list is a signal to advance to the next 

field. Expressions separated by eozomas are output one expression per 
print field. This enables output lines to be fonnatted into five left 
justified eoluams within the field. Expressions may occupy mere than 
one field, in which case the coEina following the expression in the 
PRINT list advances the print output to the next blank field. Note 
that when more than five expressions are included in. the output list 
separated by eoaoias, the terminal device after the fifth character 
will automatically generate a carriage return/line feed when its 
buffer is full to obtain the correct five column output. Printing 
will continue in as many lines as are required to complete the output 
list.. When the entire output list has been printed, a carriage 
return/line feed is automatically inserted after the last print item. 
Subsequent printing begins on the next line. For example, the 
following statements: 

10 Xs7 

20 $NAM s "PAUL" 

f^ 30 PRINT X, X+2, X+4 

40 PRINT "GEORGE", "HARRI", $NAM 

would generate the output shown below 

7 9 11 

GEORGE HARRI PAUL 

The automatic carriage return/line feed at the' end of a PRINT 
statement may be suppressed by placing a comma at the end of the 
output list. Subsequent printing will begin- in the next field of the 
same line. For- example? 

10 Xs7 

20 .$NAM="PAUL" 

30 PRINT X, X+2, X+4, 

40 PRINT "GEORGE", "HARRI", $NAM 
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would generate 

7 9 11 GEORGE HARRY 

PAUL 



Note that the terminals autoaatically generate a carriage return and 
line feed as occi2*s in the following example: 

10 FOR Is1 TO 14 

20 PRINT I-, 

30 NEXT I 

40 STOP 



RON 

1 2 3 4 5 

6 r 8 9 10 

11 12 13 14 

STOP AT 40 



More compact printing can be achieved by using semicolons rather than 
coiffiBas as expression separators. When followed by a semicolon numbers 
in the output list will print in as many characters as required to 
print the nuiabers of the expression plus one blank space added on the 
left. However, strings in the output list will print in exactly the 
end of an output list, the last item will print in a short field as 
Just described and subsequent printing will begin immediately after 
that field. For example: 



10 


S1s95 


20 


S2=87 


30 


S3s92 


40 


PRINT "SCORES AND NAME:";S1;S2; 


50 


PRINT S35 " JOE DOE" 



would generate 

SCORES AND NAME: 95 87 92 JOE DOE 
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Another example: 

10 FOR 1=1 TO 14 
20 PRINT I; 
30 NEXT I 
40 STOP 
RUN 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 

STOP AT 40 

•Note that both semic.-olons and commas may be used to separate 

isxpressions in any PRINT statement and that, the print position of the 

^ next expression will depend on the sepaza tor* (semicolon or- comma) used 

to delimit the expressions. The following example illustrates the use 

of both delimiters in a single PRINT statement. 

10 Hs98 

20 Ls60 

30 A=79 

40 PRINT "HIGHs "jEj^OWs " ;L, " AVERAGE s "jA 

would generate 

HIGHs 98 LOWS 60 AVERAGES 79 

A PRINT statement without an expression list is a valid statement. 
Execution of this statement results in the output of one blank line as 
the example below illustrates. 

(^ 10 PRINT "THERE SHOULD BE TWO BLANK LINES BETWEEN HERE AND" 

20 PRINT 

30 PRINT 

40 PRINT "HERE!" 

would generate 

THERF SHOULD BE TWO BLANK LINES BETWEEN HERE AND 

HERE! 

5.8.2.1 PRINT FORMATTING 

The PRINT statement may be used to specify the exact print format for 
the output of numeric expressions. The pound sign (#) within a PRINT 
statement fo'llowed by a hexadecimal formatting character or a decimal 
formatting string provides this capability. 
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Forms s 



[line number] PRINT .<i^ ' <exp> fj\ .... 

Q.ine number] PRINT <#,> <exp> \jJ..o. 

[line number] PRINT <#j> <8xp> (j^.... 

[line number] PRINT <3l^><string constant><exp ression> \^;/ 

[line number] PRINT <^<string variable> <expr5Ssion>{^;y' 



The formatting function may appear- anywhere within the parameter- list 
of the PRINT statement. The parameters within the PRINT statement are 
separated by coimnas or- semicolons as explained in the PRINT statement ' 
(paragraph 5.8,2) . A separator appearing at the end of the parameter 
list will foroe subsequent printing to continue on the 'same line just 
as in the PRINT statement. 

A format designator (#) followed by a semicolon, comma, or- space is 
used to output hexadecimal values in either byte, word, or free 
format, respectively. These format specifiers convert to hexadecimal 
the niomeric constant, variable or expression immediately following the 
specifier; The scope of the hexadecimal format specifier- is for the 
first constant, variable, or expression only and not for the entire 
line as in the case of print formatting using a string image. 
Subsequent values will be printed in free format decimal 
representation. 

The "#;" specifier- converts the value and outputs the hexadecimal '^ 

result as a single byte with no preceding or trailing blanks or zeros 
and without the "H« character; Only the least significant byte will 
be output for values which require more than one byte for their 
hexadecimal representation. 

The "#,«» specifier- converts the value and outputs the hexadecimal 
result as a full worrl (two bytes) with no preceding or trailing blanks 
or zeros and without the "H" character. The least significant two 
bytes will be output for values requiring more than one worri for their 
hexadecimal representation. 

The '»■#" specifier- by itself converts the value and outputs the result 
in hexadecimal free format representation. The hexadecimal result 
occupies as many digit positions as required to print the number. It 
is preceded with a zerD (0) and followed by the '»H" character. 
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The followiHg examples illustrate hexadecioal output foraatting. The 
user will teriainate the entry line with a carriage return. POWER 
BASIC outputs art designated by underlining. 

PRINT #;1j» "j#,1;" «; #1 £1^ 0001 01H 

PRINT #1311" "J^jSI;" "I #31;" "JSI IF 00 if 01FH 31 
LET As106 "~ ■ — — 

PRINT #jA;" ";#,Aj'« "jM;" «;A 6A 006A 06AH 106 

Numerie deciaai " formatting is designated within a PRINT statement 
parameter list by a print fonnat specifier* (#) followed by a format 
constant cr string variable. The format string may be either- a string 
constant enclosed in quotes which directly contains the formatting 
string, or-a string variable which has previously been assigned the 
foraatting ste*ing. 

The format staging indicates the final printed image of how the nijmeric 
e:^ressions specified within the PRINT statement parameter list are to 
be output. Fields are reserved for printing numeric data by forming 
output images of the printed results. Special characters are used 
within the format string to indicate these results. 

Several formatting strings may be interspersed within a single PRINT 
statement parameter list. Numeric output values use the last defined 
print format in that statement line for their output. Exit f r^a a 
PRINT statement line resets the formatting flag with subsequent 
niaieric values printed in free format. That is, the range of print 
formatting is limited to the print statement line in which it is 
located. Subsequent PRINT statements each require their- own print 
format specifier- (#) and string. 

Text to be output may be interspersed within the foraatting string so 
long as it contains none of the special characters used for 
print formatting. 

The special characters used in the formatting string are shown in 
Table 5--2. 

When using print formatting, floating point niomeric values ar« rounded 
to the number-of decimal places specified by the format string. A 
foraatting error- occurs if a numeric value is inconsistent with the 
specified formatting string or if the integer portion of a value 
requires more digits than specified by the fonnat string. This is 
indicated to the user by filling the entire output field with 
asterisks (•). 

The following paragraphs and examples explain the use of foraatting 
efaaraeta's. In these examples single quotesC) are embedded within 
the format field so the actual printed results can be shown mor« 
clearly. 
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.TABLE 5-2 
FORMAmNG STRING CHARACTERS 



CHARACTER 



FUNCTION 



EXAMPLE 



•N 



9 

$ 

s 

E 
< 



Decioal point specifier 
Ti;anslates to decimal point 
Suppressed if before signi- 
ficant digit 
Digit holder 

Digit holder or forces zero 
Digit holder & floats $ 
Digit holder & floats sign 
Sign holder after decimal 
Digit holder before decimal 
& floats on negative 
number 
Appears after decimal if 
negative 



PRINT #"999.99"25-.32; J^25.32 
PRINT #"999 00" 1000; KIO'.OO 
PRINT #"99,999.99"100;)515]rf100.00 

PRINT #"9999" 123; t^123 
PRINT #;»9999.999"-.23M;i$)5)iO-.234 
PRINT #"$$$. 99" 8; Jif^S.OO 
PRINT #"SSS.99" -6; Jf-6.00 
PRINT #"990. 99E"-150. 75; 150.75 
PRINT #"<« .00>" 500; 500. 00 



PRINT #"«<.0(^" -50;<50.00> 



In practice these quotes typically would not be used. The user may 
xecute these examples from the keyboard by entering the example 
through the final semicolon (;), inclusive, and then terminating the 
entry line with- a carriage return. All POWER BASIC outputs are 
underlined. • 

POWER BASIC will respond with the formatted results output between the 
quotes . 

The "9" and "0" formatting characters are used as digit holders. The 
period (.) character specifies the decimal point position on output. 

PRINT #"»99"« 5; tgt 
PRINT #"'999-. 00 ♦"25-. 32;' 25". 32 ' 
PRINT #"'99.0'" 15.575;M5TF~ 
PRINT #"» 99". 0'" 101 -.25; ***^** 

The » " formatting character also forces a zero if a non-significant 
digit is output at that position. 

PRINT #"'999.00*"28;« 28.00 ' 
PRINT #"'990. 00' ".153;' O'-IS' 
PRINT #"'990.000'". 75;' 0.750 « 
PRINT #"'990-. 000'" 1047". 23 ; ********** 
PRINT #" ♦ 000-00-000 ♦ " 3021 ; '000-03-021' 



,.^^wv 
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The "/s" fo matting character translates to a decimal point upon output 
wherever it is located in the format field. For example, this is 
useful when perfonaing monetary calculations in pennies and then 
tzmnslating the results to dollars and cents on output. 

PBINT #"'99»*O0'"200;« 2.00 ' 
PRINT #" ' 999^0 '"2532; ' 25'. 32 ' 
PRINT #«"999^0"'12000; ' 120.00 ' 

The comma (•,) fonaatting character inserts a comma in the output 
numeric value; however, it is suppressed if there are no significant 
digits to the left of its position in the output value. Typically, it 
iS'Used to separate groups of three decimal digits, (e.g., 1,000 and 
1,000, 000 h 

PRINT #"'99, 990. 00 "'3529. 87; ' 3,529.87' 
PRINT #"'99,990.00'" 903; ' ^05-.00' 
PRINT #"'99,990.00"'10.2333; ' 10.23' 

PRINT #"'99. 990. 00 '"100256. 72; *********** 

The dollar ($) sign fonnatting character is used to output the dollar 
sign with the numeric output value. It is a digit holder and also 
"floats" to the position immediately to the left of the most 
significant digit of the output value. 



ii 



PRINT #"'$$$.00'"25.32; 'i25.32 ' 
PRINT #"'$$$. 00'". 50; ' $.50' 
PRINT #" ' $$$ : 00 ' " 1 00; '100.00' 
PRINT #"'$$$.00'"1000; «****'*^* 
PRINT #"'$,$$$.00"'1.52; ' $T.52' 
PRINT #"'$$,$$$.00'" 9536; '$9,535700' 

■'^ The "S" foraatting character is used to output a signed numeric value. 

A minus sign (•») is output for a negative number and blank for a 
positive number. The "S" character is a digit holder and "floats" the 
sign of the numeric value to the position immediately to the left of 
the most significant digit of the output value. 

PRINT #"'SSS&.00'" 208.79; ' 208.79' 
PRINT #"'SSS&.00'" -20.79; ' -20-. 79' 

If the user attempts to output a negative number without using the "S" 
formatting character-, the number will be output as a positive number. 

« 

The "E" formatting character is used to output a signed numeric value 
with the sign appearing to the right of the decimal point. It 
functions only as a sign holder and is not a digit holder. 
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PRINT ^"'ggO.OOE'" 32.253; ' 32.25 ' 
PRINT #''»990.00E"'-32-.253; ' 32. 25-' 
PRINT #"'990.00E»"' -.50; ' 0.50-' 

The "<" and ">" formatting characters are used in another form of 
outputting negative numbers. They typically ars used together- in the 
formatting string. The "<" character is a digit holder and appears 
before the decimal point. The "^^ character appears after- the decimal 
point and is only a sign holder. On the output of a negative number 
both the "<" and ">" characters are output with the string. The "<" 
character will float on a negative number to the position immediately 
to the left of the most signficant digit of the output value. The ">" 
ehara.cter will appear at its position to the right of the decimal 
point on a negative number; When outputting a positive number, 
neither the "<" nor ">" -character will be output in the string. ■ ^ 

PRINT #"'<«,<«. 00>"» 1250; ' 1,250.00 ' 

PRINT #"'<«,<«.00>'" -1250; ' O-,250.00>» 

PRINT #"«<<<^.0(^»" :20; ' .20 ' 

PRINT #''»<<<.00>"'-0.2; ' <.20>' 

The following sample progiam further illustrates the results of print 
formatting. When this program is executed the user is requested to 
enter- a numeric value and formatting string-. POWER BASIC then 
outputs the number using the user supplied print formatting string. 

100 DIM F(5) 

110 INPUT "INPUT NUMBER"N" FORMAT«$F(0) 

120 PRINT " "•#$?( 0);N'""' 

130 -GOTO 110 

RUN 

INPUT NUMBER? 1 FORMAT: 999,990.99 -^ 

' 1.00' 

INPUT NUMBER? 123456 FORMAT: 999,990.99 

M23,456.00» 

INPUT NUMBER? 529728761 FORMAT: 000-00-0000 

» 529-72-8761' 

INPUT NUMBER? 2335.34 FORMAT: $$$,$$$, $$$.99E 

$2, 335-. 34 ' 
INPUT NUMBER? -234.56 FORMAT: SSSSS. 99 
' -234.56' 

INPUT NUMBER? -2335.34 FORMAT: $$$,$$$, $$$.99E 
I ig- 335-. 34— ' 
INPUT NUMBER? 1234556 FORMAT: 999,999 

INPUT NUMBER? 123 FORMAT: <<< ,<<p.-^S> 
' ■ 123.00' 

INPUT NUMBER? - 1234 FORMAT : < « K<9'99> 
•<1,234%Q0>' • 
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Output fo matting can also be controlled by use of the TAB function. 
Forms 

i 
I 
{ 

TAB (<expression>) ' J 

The expression in the T^B function specifies the horizontal column 
position where the print item following the TAB will begin printing. 

-The TAB function may contain any expression as its ai^gument. The 
expression is evaluated and its integer portion used. If the result 

;-is- greater than the line size, the specified print item will be 
printed on the next output line. If the column specified by the 
integer part of the expression has already been passed in the current 
print line, the TAB function will be ignored and the print item will 
be output at the current position in the print line. The TAB function 
may be used to format output into columns on the output device- 
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10 PRINT "BIG" J TAB(20^j"SPACE" 
will generate 

BIG SPACE 

wnxxe 

10 PillNT TAB (20-); "SPACE" ; TAB (V); "BIG" 

will generate 

SPACEBIG 

In the first example, the string "BIG" is output starting in column 
1. The TAB function advances the .printer to column 20 and outputs the 
string "SPACE". Ih the second example, the TAB Function advances the 
printer to column 20 and outputs the string "SPACE". The TAB (1) 
attempts to return the printer to coluian 1 in the print line. Since 
that column position has already been passed, the string "BIG" is 
output iumediately following "SPACE" (the current position, on. the 
print line). 

5.8.2.3 PRINT STATEMENT CURSOR CONTROL 

In conjunction with the PRINT statement, the user aay position the 
cursor to any location dni the video display terminal log device. 
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Cursor cootrol is performed on the Host POVJER BASIC Interpreter with 
the use of the i operator. Note that cursor positioning is supported 
only by the Host POWER BASIC Interpreter and not by the Target POWER 
BASIC Interpreter. Therefore cursor positioning should not be 
Included in a final application program which is to be configured into 
a customized (Target) POWER BASIC Interpreter for execution in a TM990 
board system. 

Forms : 

[line number] PRINT i«expl>,<exp2» {-j <variable>{;} {;} 

, (Jine number] PRINT §<$var> ; <variable> {j| .... {If 

Cursor control via the § operator nay appear numerous times and at any 
position within the PRINT statement. It appropriately positions the • 
cursor before performing the output of any succeeding variables, 
expressions, cr string constants. 

By using the •'§(<exp1>,<exp2>)'' form, the cursor can be positioned to 
any location on the 911 or 913 VDT terminals as specified by expl and 
expa-. <Exp1> specifies the ROW position, while <fexp2> specif ies the 
COLUMN position where the cursor is to be positioned. The 911 video - 
display terminal has 24 rows of 80 characters (ie., 24 ROWs and 8 
columns), while the 913 video display terminal has only 12 rows of 80 
characters (ie.,- 12 ROWs and 80 COLOMNs)-. The COLUMN values expected 
by POWER BASIC range from to 79, while 'the ROW values range from 
to 11 and to 23". The expressions are evaluated and their integer 
portions are used. The user should limit the range of <exp1^ and 
<exp2> to the values given above. 

Examples : ^^^ 

10 DIM STR(IO) 

20 INPUT §«C"; "INPUT I-POSITION ";Y 

30 INPUT "INPUT X-POSITION "jX. 

40 INPUT "INPUT STRING ";$STR(0) 

50 PRINT §"C"j§(I,X);$STR(0) 

60 INPUT §(G-,0);"TIPE C/R WHEN READY TO CONTINUE ":A 

70 GOTO 20 

80 STOP 

This example will request user input of the X and X positions, and the 
character string to be output. The user enters these values, and then 
the Host POWER BASIC Interpreter will appropriately position the 



5»48 



cursor and output the character string-. It then returns the cursor to 
the upper left hand comer and waits for the user to enter a carriage 
return to continue for the next position parameters and character 
string. 

10 $STRs"*« 

20 INPUT •§"C'«;''HOW MAN! ROWS ON YOUR TERMINAL, 12 or 24? ''•,ROW;§"C'' 

30 ROWsROW-1 

40 FOR 1=1 TO 200 

§0 PRINT §<-ROW«RND,(80-.LEN($STR))«RND3;$STR 

60 NEXT I 

70 TlsTIC(O) 

._ . . 80 IF TIC(T1K5 THEN GOTO 80 

90 PRINT §"0" 

100 GOTO 40 

1 10 STOP 

This program outputs an asterisk (*) to two hundred random locations 
on the screen of the 911 or 913 TOT's, waits for 5 seconds, and then 
clears the screen and repeats the sequence. 

By using the-"g<$var>'' form, the user can specify several additional 
screen cursor positioning commands (eg., HOME, CLEAR, and BEGINNING). 
They also permit 7DT independent cursor positioning by moving the 
cursor to the RIGHT, LEFT, or DOWN. The <$var> may be either a string 
constant or string v^i^iable specifying the sequence of cursor control 
commands. The special character codes used in the <|var>> are as 
follows? 

CODE ACTION 

B Move cursor to beginning of line 

^ C Clear screen and move cursor to HOIffi position 

D Move cursor down 

H Move cursor to HOME position 

L Move cursor to left 

R Move cursor to ri#it 

Any of these codes may be proceeded by positive integer representing 
the number of times the following code is to be repeated when the 
$var is output. 



10 Hm SCR(5) 

20 $SeR(0)s"C5I510R" 

30 PRINT §$SCR(0^;«5 DOWN AND 10 TO THE RIGHT" 

40 PRINT §"H5D20R10L'';''5 DOWN AND 10 TO THE RIGHT" 

50 PRINT f"C";§(5-,10^;"5 DOWN AND 10 TO THE RIGHT" 

60 STOP 
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The three PRINT statements of this example will produce the same 
results, in that the cursor will be positioned at the 5th row, and 10 
column before the string is output. Statements 30 and 50 will 
however, clear the screen before the cursor is positioned. 

Target POWER BASIC Interpreter: PRINT statement cursor .control is not 
supported, by the POWER BASIC Configurator. Therefore, cursor control 
should not be presented in the final application to be configured into 
a customized (Tainget) POWER BASIC Interpreter. 

5-8.2.4 SUMARI - PRINT STATEMENT RULES 

The PRINT statement may contain the following elements; any number of 
times and in any sequence within the expression list. The only ^ 
restriction is that no two expressions (exp) may appear* together 
without a separator between them. Valid separators are a comma (,), a 
semicolonC; ) , or a pound sign (#)% An expression is defined as any 
arithmetic combination of numeric constants/ variables, or functions. 
For example, PRINT 3+5 2*SQR(A), is an illegal statement. 

<exp> ^ May not appear together without a separator 

<var^ \ between them. 

'' string- ^ 
TAB 

Separators 



Most users insert redundant semicolons (;) and parenthesis within the 
expression -list of PRINT statements to facilitate readability and 
clarity. However, the experienced user may eliminate many of these -^ 
redundant characters to save memory area and increase the speed of 
in te rp rete r ■ execution ♦ 

The following examples show the typical foraat of a PRINT statment: 

100 PRINT "As^jAj^Bs'^jB 

110 PRINT A;TAB(10);»*HI";#"999-99";A;TAB(25};B 

120 PRINT 25;$Bj''STRING";B 

130 PRINT $A;$B 

140 PRINT B;$A;C 

These statements could be altered to: 

100 PRINT ''As^A^Bs^'B 

110 PRINT A TAB 10 »»HI"#"999.99"A TAB 25 ;B 

120 PRINT 25 $B '^STRING" B 
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130 PRINT $A $B 
140 PRINT B W,0 

Tbe following examples Illustrate invalid PRINT statement expression 
lists; 

100 PRINT A B 25 

110 PRINT 250 SQR(A) 

120 PRINT $A B 15 

130 PRINT 5»SQR(A) A*B/C 

Tbese statements must be written as; 

100 PRINT A;B;25 

^^ 110 PRINT 250; SQR(A) 

120 PRINT $A;B;15 

130 PRINT S*SQR(A);A«B/C 

These techniques should only be used in programs which will never be 
read by other than expert POWER BASIC progransiers . Saving space and 
time at the expense of program clarity may cost more in the long ran 
than you are willing to pay. 

5.8.3 DIGITS STATEMENT 

The DIGITS . statement specifies the number of significant digits to be 
printed in format free output c 

Forms: 

[line number] DIGITS <|expression> 

The expression may be any numeric constant, variable, or expression 
which is evaluated and its integer portion used. The range is from 1 
to 11 for the expression of the DIGITS statement. If the expression 
is outside these limits, a DIGITS OUT OF RANGE error will result. 
From the DIGITS statement on in the program, all format free printing 
will display a maximxim of the specified number of decimal digits until 
another DIGITS statement or SAVE statement is executed. When saving a 
program, POWER BASIC first internally executes a DIGIT 8 statement and 
then proceeds with saving the program. Therefore, in programs which 
are to be SAVEd, all constants declared in the program should have no 
more than 8 significant decimal digits. 

Examples: 

DIGITS 3 (In keyboard mode) 

PRINT 4*AT!I(1)j 3.14 (In keyboard mode) 
10 DIGITS 8 
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20 PRINT 4*ATN(1) 

30 DIGITS 11 

40 PRINT 4»ATN(1) 

50 STOP 

RUN 

3.1415926 
3.1415926595 

STOP AT 50 

When .using fonnat free output the following roles for printing numbers 
will assist the user in interpreting the printed' results. 

1. If the result is an integer number with an absolute value less 
than IO^DIGITS-1), POWER BASIC will output the number in decimal, 
format preceded by a minus sign if negative or a blank if positive. 
(i.e., if DIGITS s 7 then x 10°.) 

2. If the result is a floating point number with an absolute value 
less -than 10^DIGITS-1) but greater than 10 -(DIGITS-^ X, POWER BASIC 
will output the number in decimal format prededed by a minus sign if 
negative or a blank if positive (i.e., if DIGITS = 7 then 10-6>|x( 
>10 ^ ). If the. number of significant digits is more than what is 
specified by the digits, statement, the number will be rounded to the 
specified number of digits before output. Zeros trailing the decimal 
point are suppressed. 

3. If the number is an integer or- a floating point number with an 
absolute value greater 'than 10^DIGITS-1) or less than lO^(DIGITS-l) , 
the number- is rounded to the number of digits set by the DIGITS 
statement (if required), and is printed in exponential format. POWER ^ 
BASIC prints exponential results as: 

a) a blank 

b) a minus sign if negative 

c) the first digit of the number 

d) the decimal point 

e) the remaining digits 

f) the letter "E" (indicating exponent) 

g) a minus sign if the exponent is negative 
h) the exponent value printed as two digits 
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Examples s (Using DIGITS 7 for output) 

PRINT 123; 123 
PRINT -54. 546 I -54,546 
PRINT -.0000000123? 1.23E-8 
PRINT 32437580259? 3-.243758E10 

Target POWER BASIC Interpreter; The DIGITS statement is not supported- 
by the POWER BASIC Configurator, therefore the DIGITS statement should; 
not be present in any final application program to be configured into' 
a customized (Target) POWER BASIC Interpreger. 

5. 8. 4 OUTPUT CONTROL STATEMENTS 

, - The UNIT and SPOOL statements are used to direct output to "the various 
devices on the system. . * 

5-.8.4%1 SPOOL STATEMENT 

The SPOOL statement is used to indicate the secondary output device 
cont railed by the UNIT statement. 

, FORM: 

D-ine number] SPOOL <exp?r TO <nuaeric variable> 

The SPOOL statement in combination with the UNIT statement directs 
output to one or more specified devices on the system. The expresison 
is evaluated and the result is the unit number to which spooling is 
assigned. The numeric variable designates the secondary device to 
which output will be sent. The numeric variable contains the logical 
unit number (LUNO) returned by a BOPEN statement, and represents the 
f^. TX990 pathname of the output device/file. Spooling is typically 

performed to the line printer, a diskette file, and the 733 ASH 
Printer. 

The current version of the Host POWER BASIC Interpreter supports 
output spooling to only one secondary device at a time. This implies 
that the valid unit numbers of the UNIT statement are 0,1,2,3. 
Unit stops all terminal output, Unit 1 is assigned to the 911 VDT or 
913 VDT terminal device. Unit 2 is the spooling unit number, and Unit 
3 directs output to both Units 1 and 2. Therefore, the expression of 
the SPOOL statement must always evaluate to 2 to be a valid spooling 
unit number. For examples of the SPOOL statement see the UNIT 
statement below, Paragraph 5.8,4%^. 

Target POWER BASIC Interpreter; The SPOOL statement is not supported 
by the POWER BASIC configurator, therefore the SPOOL statement should 
not be present in any final application program which is to be 
configured into a customized (Target) POWER BASIC Interpreter. 
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5.8.4.2 UNIT STATEMENT 

The UNIT statement designates the device or devices to which all 
subsequent output will be sent. All output will be directed to the 
deviee(s) selected, including LIST output, BASIC conmand/stateffient 
output, and all program generated output. The devices/files will 
remain selected for- output until a subsequent UNIT statement is 
encountered. 

Forms: 

p.ine numbeifj UNIT <expression> 

The uifIT stetement is one of the POWER BASIC statements which produces 
similar- results, but functions differently on the Host POWER BASIC 
Interpreter than on the Target POWER BASIC Interpreter. These 
differences will be presented below in their respective sections. 

Host POWER BASIC Interpreter: 

The expression may be any numeric constant, variable, or expression 
vrtiich is evaluated and its integer portion is used. The valid range 
of UNIT numbers area 0,1,2, and 3-. A UNIT value of will stop all 
output to any devices, a UNIT value of 1 will direct all output to the 
tenain-al device, an UNIT value of 2 directs all output to the 
device/ file designated by the SPOOL statement, and a UNIT value of 3 
directs all output to both the terminal device and the device/fUe 
designated by the SPOOL statement. 

Examples: 

10 BOPEN "LP", LP 

20 SPOOL 2 TO LP 

30 UNIT 3 

40 REM ALL SUBSEQUENT OUTPUT WILL BE DIRECTED TO BOTH THE 

50- REM TERMINAL DEVICE AND THE LINE PRINTER. 

This example would direct any subsequent output to both the terminal 
device and the. line printer, until another UNIT statemnet is 
encountered. 

BOPEN "DSC2:PROB/0UT'',0UT 
SPOOL 2 TO OUT 
UNIT 2 
RUN 

This example- would direct all output of the POWER BASIC program 
executed by the RUN command to the diskette file named: PROG/OUT. All 
program inputs would still be from the log device, but no printing 
would occur on the log device until execution of a UNIT 1 or UNIT 3 
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statement . 

Target POWER BASIC Interpreter: 

The expression may be any numeric constant, variable, or expression 
•Hbiefe is evaluated and its integer portion is used. The valid range 
of UNIT numbers are 0-, 1,^,and 3". The UNIT statement is used in a 
Target POWEB BASIC application which requires output to both ports of 
a TM990/101M microcomputer board. The UNIT statement can direct 
output to either or both of the serial interfaces present on the 
134990/ 10tM. (Note that the TM990/100M microcomputer board has only one 
serial I/O port, and therefore the UNIT statement will only affect the 
.©litput to port A of this board.) 

r^ The UNIT number assignments are as follows: 

UNIT SEHIAL I/O PORT 

NEITHER PORT A NOR B 

1 QNLI PORT A (-CRU s OO8O16 ) 

2 ONLI PORT B (CRU s 0l80,g ) 

3 BOTH PORTS A AND B 

Note that the baud rate of Port B must be set by executing the "BAUD 
1,X" statement as described in paragraph 5.8.5 below before Port B 
should be referenced in a UNIT statement (eg., UNIT 2 or UNIT 3). 

Examples: 

10 BAUD 1,il 

20 UNIT 3 

30 PRINT 4«ATN(1) 

In this example sLU subsequent output will be directed to both ports A 
and B of the TM990/101M microcomputer board. 

The UNIT statement may be used to momentarily stop output to the 
primaiy terminal device. This would be useful to disable echoing of 
characters on an INPUT statement as follows: 

50 UNIT {DISABLE BOTH PORTS A AND B 

- - 60 INPUT ;$CHR(0) -'INPUT VALUES FROM TERMINAL WITHOUT ECHO 

70 UNIT 1 ! ENABLE PORT A 

5.8.5 BAUD STATEMENT 

The BAUD Statement is used to set the baud rate of the serial I/O 
pert(s) of the Target TM990 system via program statement control. 
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Forms: 

. [line nimber] BAUD <expression 1>-, <expression 2> 

The BAUD statement sets the baud rate of the serial I/O port(s) of 
only the Target TM990 system^ It does not affect POWER BASIC program 
execution on the Host POWER BASIC Interpreter. The BAUD statement, 
when encountered on the Host POWER BASIC Interpreter, will l5e checked 
only for syntax, and will otherwise be skipped, and the next statement 
will be executed* The BAUD statement is used in application programs 
to be configured into a customized BASIC Interpreter to appropriately 
initialize the BAUD rates of the serial I/O port(s) of the TM990 
boards when powered up and RESET. 

The BAOD statement, when encountered on the Target POWER BASIC 
Interpreter will perform as fallows • 

The BAUD statement will initialize the TMS9902 Asynchronous 
Communications Controller of either port A or B as specified by 
expression V, to the baud rate specified by expression 2\ 

Expression 1 will be evaluated and its integer portion will be used. 
A zero value for expression 1 will select port A CCRU address of >80) 
of the TM990/100M or TM990/101M microcomputer board, while a non 
zero value will select port B (CRU address of >180) of the 
TM990/101M microcomputer board. 

Expression 2 will ^be evaluated and its integer portion will be used. 
The table below presents the valid range for expression 2 and the 
corresponding baud rates. 



Expression 
Value 






Baud 
Rate 



1 
2 
3 
4 
5 
.6 






19", 200 
9600 
4800 
2400 
1200 
300 
110 


Examples : 








10 BAUD 
20 BAQS 


1-, 


,0 
,2 





Host POWER BASIC Interpreter: The BAUD statement is only checked for 
syntax when executed on the Host POWER BASIC Interpreter, and is 
otherwise skipped and the next statement is executed. 
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5«9 INTERRUPT PROCESSING 

Tbree statements are supplied for interrupt processing using a BASIC 
language siib routine c These statements have the following form: 

[line numbecl DiaSK <expression> 

[line number] TRAP <expressioE> TO Cine number> 

Q.ine niambe^ IRTN 

The IMASK statement allows the liser to control the interrupt mask of 
the processor • The TRAP statement associates an interrupt level with 
the statement number entry point for the interrupt processor 
subroutine written in BASIC. The user will return from this 
subroutine with the IRTN statement* 

^ The interrupt processing statements are used only in the Target POWER 

BASIC Interprets. They are non-operations (NOPs) in the Host POWER 
BASIC Interpreter since the TX990 Operating System and the FS990 
system use many of the interrupt vectors for its interrupt driven 
device interfaces* The interrupt processing statements IMASK and TRAP 
are checked for syntax when encountered in a program, however they are 
otherwise skipped, and the next statement is executed; The IRTN 
statement, on the otherhand, performs as a RETURN statement, that is, 
it removes the top item off the GOSUB stack, and retursn to the point 
in the BASIC program from where it was called. This is useful in 
testing BASIC Interrupt processing routines by selectively executing a 
GOSUB to the entry point of the interrupt handling routine, and then 
returning using- the IRTN statement as would be done in the finis.1 
application. 

The following sections explain how the interrupting processing 
statemetns function in the Target POWER BASIC Interrupt and applica«> 
tion* 
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5.9.1 331ASK STATEMENT 

The IMASK statement is used to control the interrupt mask of the 
TMS9900 microprocessor. The TMS 9900 microprocessor employs 16 
interrupt levels with the highest priority level being 0, and the 
lowest 15^. Level is reserved for the RESET function; all other 
. levels may be used for external devices. The external levels may also 
be shared by several device interrupts, depending on system 
requirements. Since the reset sequence at power-up sets the interrupt 
mask to zero, the appropriate interrupt mask* must be set before any 
interrupts will T^e acknowledged. 

Note that if the current level is less than 3', setting of the system 
time by using the TIME statement will result in the interrupt mask 
being set to level 3'« Likewise, if the real time clock is being used 
(located at interrupt level 3)? and if the mask is subsequently set to 
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less than 3', the clock interrupts will no longer be acknowledged and 
real time will be destroyed. 

All interrupts before they reach the TMS9900 CPU are first masked by 
the TMS9901 Programaable Systems Interface. To prevent unwanted 
interrupts from being acknowledged, the user must appropriately set 
the interrupt mask of the TMS9901 to select all interrupt levels t^ich 
are to be processed. This is performed via the CRU interface using 
the BASE, CHB, and CRF POWER BASIC statements. 

Exajsples: 

10 IMASK 15 ! SET MASK TO 15 

. 20' IMASK OEH ! SET MASK TO 14 

30 AsOAH ! SET A TO 10 

40 IMASKA I SET MASK TO VALUE OF A ^-*> 

Host POWER BASIC Interpreter: The IMASK statement is only checked for • 
syntax when executed on the Host POWER BASIC Interpreter, and is 
otherwise skipped and the next statement is executed. 

5.9.2 TRAP STATEMENT 

The TRAP statement is used to define the entry point of the interrupt 
subroutine for a given interrupt level. The level "expression" may be 
any valid POWER- BASIC expression whose integer portion is used and 
whose value is masked to the least significant 4 bits. The "line 
number" specifies the entry point for the interrupt servicing routine. 

The TMS9900 Microprocessor continuously compares the incoming 
interrupt code with the interrupt mask as set by the IMASK statement. 
When the level of the pending interrupt is less than or equal to the 
current mask level (a higher or equal priority interrupt), the 
processor recognizes the interrupt. Note that interrupts are '^ 

acknowledged immediately and the mask value is appropriately set, but 
that the BASIC interrupt processor will ohly be entered following 
completion of the currently executing statement. A statement is 
terminated by either an end of line or by the double colon ( : : ) 
statement separator. 

After an interrupt occurs, the interrupt mask is set such that the 
current interrupt level is disabled and only higher priority levels 
are enabled (the mask value set to one less than the level of the 
interrupt being serviced). Should a higher priority interrupt occur 
while servicing an interrupt, the interru|)t processor will complete 
the current statement and then transfer to service the higher priority 
level interrupt. Upon completion of higher level processing, an IRTN 
statement is used to terminate the higher level interrupt servicing 
routine, restore the previous service routine parameters to the 
processor, and return control to the previous service routine at the 
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point which- the higher priority interrupt occurred to complete 
processing of the lower-priority interrupt o Should a lower level 
interrupt occur, it will Remain pending until the interrupt mask is 
raised to allow the interrupt. 

Note that interrupt levels (RESET) and 3 (clock) are reserved and 
should not be serviced by the TRAP statement. 



Ex: 


smples 
10 


« 

TRAP 5 TO 500 


! 


ASSIGN LEVEL 


5 TO LINE 500 




20 


TRAP OEH TO 100 


! 


ASSIGN LE7EL 


14 TO LINE 100 




30 


Asaoo 


! 


SET LINE 






40 


BsOCH 




SET LEVEL . 






50 


TRAP B TO A 


! 


ASSIGN LEVEL 


12 TO LINE 200 



Host POWER BASIC Interpreter: The TRAP statement is only cheeked for 
syntax when executed on the Host POWER BASIC Interpreter, and is 
otherwise skipped and the next statement is executed. 

5.9.3 IRTN STATEMENT 

The IRTN statement is used to return from an interrupt servicing 
processor. IRTN is the last statement and terminates the interrupt 
servicing processor. It will restore the program environment existing 
when the interrupt was taken, and will return control to the previous 
routine at the point at wiich the interrupt occurred. 

Examples : 

190 IRTN ! RETURN FROM INTERRUPT LEVEL PROCESSING 

Host POWER BASIC Interrupt: The IRTN statement when executed on the 
Host POWER BASIC Interpreter performs like the RETURN statement, and 
removes the top item off of the GOSUB stack and returns to the 
position in the BASIC program trem where it was called. 

5.9.4 ASSEMBLY LANGUAGE PROCESSORS 

There are times when it maybe necessary or advisable for the interrupt 
processor to be written in assembly language. This may be 
accomplished in two ways when using the Target POWER BASIC 
Interpreter. The first is to use the TRAP statement and the CALL 
statement to access the assembly language routine. The second is to 
modify the interrupt transfer vectors for the desired interrupt level 
so that an interrupt will transfer to the assembly language routine 
directly. 

Low-order memory, addressed as through 3F, is reserved for the 
transfer vectors used by the interrupts. When an interrupt request at 
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an enabled level occurs, the contents of the transfer vector 
corresponding to the level are used to enter the subroutine to sev^e 
the interrupt. 

The reserved memory locations are shown in the Interrupt Level Data 
table (Table 5.3)* Two memory words are reserved for each interrupt 
level. The first of the two words for- a given level contains an 
address that is placed in the WF when the interrupt is requested and 
enab-led. The second contains the entry point of the interrupt 
subroutine for that level; its contents are placed in the PC. 

To install an assembly language interrupt processor into the Target 
POWER HASIC Interpreter, the user must modify the object module 
produced by the TXDS Link editor before programming this object module 
^into EPROM. The transfer* vector for the desired interrupt level must 
be modified to reflect the new workspace pointer* and the new entry ^^ 

point for the interupt level must be modified to reflect the new 
workspace pointer* and the new entry point for the interrupt handling 
routine. The object module produced by the TXDS Link Editor has its 
origin at hex address 0000 jig , therefore the transfer vector locations 
are appropriately offset frxsm the beginning of the object module (ie., 
offsets O^g through SFj^g are the transfer vectors) . The EPROM set may 
then be programmed with this modified object module containing the 
desired interrupt transfer vector. 

All assembly language interrupt processors must supply their own 
workspaces, therefore RAM must be allocated for this purpose. During 
power up reset,* POWER BASIC will automatically sire all available ' 
contiguous RAM from hex FFFE j^g on down for its own use. Consequently, 
the user must supply a non-contiguous RAM area for the workspaces in 
the Target POWER BASIC system. 

Note that interrupts serviced by assembly language processors are ^ 

handled transparent to POWER BASIC; that is, a) the transfer to the 
interrupt service routine is external to the POWER BASIC processor 
(POWER BASIC has no knowledge an external interrupt has occurred), and 
b) the transfer is made immediately upon receiving the interrupt 
(current BASIC statement execution is not completed before 
transferring). For- these reasons all assembly language -^interrupts 
must have a higher priority than those handled by POWER BASIC; it is 
acceptable for* an assembly language processor- to interrupt a POWER 
BASIC interrupt processor but the reverse should never be allowed to 
occur: 

Since assembly language interrupts are processed immediately and the 
POWER BASIC envirorment prior to the interrupt is not saved, it is not 
advisable tg use the Floating Point XOPS of POWER BASIC in the 
assembly language processor. 
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TABLE 5-3 
INTERRUPT LEVEL DATA 
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Interrupt Mask 






Vector Location 




Values to Enable 


IatesT«pt 


(tJeffloiy -Address 


Device 


Respective Interrupts 


Level 




la Hex) 


Assignment 


(ST12 thru ST15) 


(Highest 










priority) 


00 


Reset 


through F» 




1 


04 


External device 


1 through F 




2 


08 


External device 


2 through F 




3 


DC 


Clock 


3 through F 




4 


10 


External device 


4 through F 




5 


14 


External device 


5 throu^ F 




6 


18 


External device 


6 through F 




7 


1C 


External device 


7 threu^ F 




8 


20 


External device 


8 through F 




9 


24 


External device 


9 through F 




10 


28 


External device 


A through F 




11 


2C 


Exteraal device 


B through F 




12 


30 


External device 


C through F 




13 


34 


Exteraal device 


D through F 




U 


38 


External device 


E and F 


(Lowest 










Priority) 


15 


3C 


Exteraal device 


F only 



*Leve-l can not be disabled. 



f^ 5.10 BASE STATEMENT 



Fona: 



Cline number] BASE <exp r«ssioi?> 



The BASE statement sets the CRD base address for subsequent CRU 
operations. 



The BASE Statement evaluates the expression and sets the CRU base 
address to the result for use by teh CRB and CRF functions. The CRB 
function addresses bits within +127 and -128 of the evaluated base 
address. • The CRF function transfers bits using the evaluated base 
address as the starting CRU address. 
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The CRU provides a maximum of 4096 input and output lines that may 
be individually selected by a 12-bit address. The 12-bit address used 
by the CRU instructions is actually located in bits 3 through 14 of 
a workspace register. The evaluated expression of the BASE 
statement is loaded into the entire l6-bits of this workspace 
register. Therefore, the BASE expression should evaluate to twice the 
actual (physical) -CRU base address desired since only bits 3 throgh 14 
are used. The least significant bit of the BASE exp ression value is 
ignored for- CRU operations. Therefore, all expressions should 
evaluate to an even number. The lange of valid expressions is from 
.0 to 8190 (hexadecimal 1FFE). 

Examples : 

10 BASE 64 

20 CRF(0)s— 1 ^/«nsi^ 

30 BASE 100 

40 CRB(--1)s0 

Statement 10 sets the CRU BASE address to 64 (physical address of 32), 

and statement 20 outputs a l6-bit -1 value. Statement 30 sets the CRU 

BASE address to 100 (physical address of 50, and statement 40 sets the 

CRU bit displaced -1 from the base (physical address of 49) to zero. 

5.11 TIME STATEMENT 

The TIME statement is used to display, store, or set the 24 hour- time 
of day clock, 

Fo nas : 

{line numbei^ TIME 

^ine number] TUffi <string variable> 

jline -numberj TIME <exp> ,^xp> ,<exp>. 

The time of day may be directly displayed at any point within the 
program. It may also be displayed from the keyboard when in idle mcde 
by using the first form of the TIME statement. The time of day will 
be displayed in the fallowing format: 

•HHjMMjSS 

Examples : 

time' 9: 31 J 23 (in keyboard mode) 
10 TIME 11-,4',0 
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100 TIME 
110 STOP 

RUN 
11:04s37 

STOP AT 110 

The second fom of the TIME statement enables the current time of day 
to' be stored in a string variable. This is useful for recording 
. occurrence time of significant events in a user's application 
i#»K. program. 



10 DIM T(3) 
20 TIME 11,4,0 



100 TIME $T(0) 
120 PRINT $T(0) 
130 STOP 

RUN 
11s04j37 
STOP AT 130 

The TIME statement is one of the POWER BASIC statements which 
f^ functions slightly different on the Host POWER BASIC Interpreter than 

on the Target POWER BASIC Interpreter. The difference between the two 
systems in the operation of the TIME statement lies solely in the 
setting of the time. These differences will be presented in the 
appropriate paragraphs below. 

Host POWER BASIC Interpreter! 

Setting of the time via the "TIME- <exp> , <exp>, <exp>.« statement is not 
supported on the Host POWER BASIC Interpreter, Instead the user will 
set the time by using the INITIALIZE DATE AND TIME (ID) command of the 
SYSUTL program module. The user must set the time and date (if TIME 
is desired during BASIC program developemnt) before executing the Host 
POWER BASIC Interpreter. 

To set the time, the user must load srsUTL using either OOP or the 
TXDS Control Program by performing the steps in "Diskette OC? System 
Utility (SYSUTL) Program" (Section 7III of the TX990 OPERATING SYSTEM 
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PROGRAMMER'S GUIDE)-. In respons"« to the "OP:" prompt, the user will 
enter the ID command. The syntax of the command is as follows: 

ID , <yea r>., ^onth> r<4ay> , <hou p>, ^minu te>. , 

The yearoperand is the four-digit] decimal number of the years 1976 
through 1999, and the month ope rank! is the decimal number of the month 
1 throu^ 12. The day operand is k, one- or two«-digit decimal number, 
1 through 31, and the hour* ope ]|and is a one- or two-digit decimal 
numb^, through 23. The minute is the decimal number-of the minute 
through 59. The second is set to zero when the command is entered. 

Example ^: - 

OPt 135,1978,11,15,15,28. '-^ 

15:28:00 NOV 15, 1978 

Note that the ^TIME <exp>, <exp> , <exp> » statement will t>e accepted by 
the Host POWER BASIC ' Interpreter and will be checked only for 
statement syntax. Execution will continue with the next POWER BASIC 
statement. Therefore the user may insert the appropriate "tUS <exp>., 
^xi5> ,.<exp>'' statement into the application program, it- will have no 
effect in Host POWER BASIC Interpreter execution, and It will be 
appropriately configured into the Target POWER BASIC Interpreter. The 
user will enter the "TUS <exi^ r^^^xp^ r<'^.xp>"- statement into the appli- 
cation program according, to the explanation below on the Target POWER 
BASIC Interpreter. 

Tanget POWER BASIC Interpreter: 

The "TIME <exp>,<exp>,<exp>'' statement is used to start and set the 

time of day clock of the Tariget POWER BASIC Interpreter on the TM990 "^ 

board system, the form of the expressions is as follows: 

TIME HH,t^,SS 

where 

H s hours, M s minutes, S s seconds 

The clock, of the Target POWER BASIC Interpreter is set up as a 24-hour 
clock with times ranging ft«om 00:00j00 to 23:49:59. Initialization of 
the clock is valid at any point wihtin the application program. Its 
value, may be reinitalized at any point. 

Examples: 

10 TIME 9,0,0 ,1 

10 TIME 12,30,0 i: 
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To dirtetly set the time within a configured application program as 
illustrated in the above examples, requires that the POWEH BASIC 
system to be initialized at the exact time specified within the 
program in oirler fcr the TIME statement to be accurate. The typical 
method of setting the time ia a configured application program of the 
Tai^et POWER BASIC Interpreter is illustrated in the following 
program. 



10 PRINT "INITIALIZE TIME-OF-DAI aOCK« 

20 INPUT "HOURS = "jHRS, "MINUTES s ";MIN, "SECONDS s ":SEC 

30 TIME HRS,MIN,SEC 



5-. 12 RANDOM STATEMENT 

The RANDOM statement randomizes the seed for the pseudo-random number- 
generator. 

Formss 

&ine nuabeij RANDOM <expiession> • 

The RANDOM statement is used in conjunction with the RND function. 
The RND functio-n returns the next number- in the random number 
sequence. It returns this value when requested and replaces it with 
the next random number; The RANDOM statement is used to change the 
random number seed and therefore the sequence of pseudo- random 
numbers. 

The random seed is set to a constant value when POWER BASIC is first 
initialized so that the RND variable will always return the same 
sequence of numbers to facilitate program debugging. After the 
debugging phase, the RANDOM statement may be used to alter this 
sequence. 

The RANDOM statement is used to set the seed to a specific or 
arbitrary value. The expression is evaluated and the result used as 
:.-. the seed of the random number- generator; The expression may be any 
valid POWER BASIC expression. The evaluated expression must be within 
the limits of -32768 and 32767 or a FIX .ERROR will result. The 
sequence of numbers generated by a specific seed value will always be 
the same. This is useful for debugging and testing an application 
program with a predetermined seed value. Arbitrary seed values may be 
generated by the user by using combinations of variables and functions 
(including the RND function) within the expression. 
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Examples : 



10 RANDOM 220 

20 RANDOM 1000»RND 

30 RANDOM RND«MEM(X) 



5.13 ESCAPE AND NOESCAPE STATEMENTS 



The ESCAPE and NOESC statements provide the capability to enable or 
disable the escape key to interrupt program execution on the Host 
POWER BASIC Interpreter. These statements are not supoorted by the 
Tai:ige-t' POWER BASIC Interpreter and therefore function as a STOP 
statement if encountered within a application program executing on the 
Target BASIC Interpreter. -^ 

Cline number] ESCAPE 
QLine number] NOESC 

The ESCAPE statement enables the terminal device escape (or break) key 
to interrupt program execution. The escape key is normally enabled in 
POWER BASIC unless an NOESC statement has been executed. When the 
escape key is struck, the program terminates upon completion of the 
current statement line. Keyboard sampling during the RUN mode is 
performed only between statement lines. Caution should be observed 
when certain statement constructions are used. For example, the FOR 
and NEXT statements should not appear in the same statement line, 
because a statement Une is autonomous. Once the FOR/NEXT line begins 
execution, it cannot be interrupted by using the escape 
ker. - It can be- interrupted only if the end condition of the FOR/NEXT 
loop is met, or if the user reinitializes the system via the reset 
swtieh on the CPU board. 

The NOESC statement disables the terminal device escape (or break) key 
from interrupting program execution. 

The ESCAPE statement (default condition) is used during program 
development and debug. The NOESC statement is used for time critical 
application programs or in an environment wher« it is not desirable 
for the user to interact with POWER BASIC in a non-program controlled 
mode. 

Examples: 

10 ESCAPE 
10- NOESC 
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Target POWEB BASIC Interpreters The ESCAPE and HOSSC statements are 
not supported by the POWER BASIC Configurator, therefore these 
statements should ast be present in a final application program whieh 
is to be eonfigured into a customized (Target) POWER BASIC 
Interpreter. The statements will function as a STOP statement if 
encountered in a Target application program. 



5.14 CALL STATEMENT 



The CALL statement allows the user access to assembly language 
subroutines. The user may pass up to 4 patameters to the subroutine 
although none are required. 



,e number] CALL <strlag constant>,<address><,var1><,var2><,var3><,var4> 
where s 

string constant is the entry point of the assembly language 
subroutine 

address is tije hexadecimal or decimal address of the assembly 
language subroutine 

varl', var2-, varS, and varU are the parameters of the subroutine 

The string constant is the entry point of the assembly language 
subroutine being called (used by the POWER BASIC Configurator and the 
Target POWER BASIC Interpreter). The address is the decimal or 
hexadecimal address where the asembly language subroutine resides 
(used by the Host POWER BASIC Interpreter). Both the string constant 
and the address parameters must be entered to execute the CALL 
statement, although only one is used by each of the two POWER BASIC 
Interpreters. 

Parameters are passed to the assembly language subroutine via the 
variables <var1> through <var4>. Up to four parameters may be passed 
between the POWER BASIC program and the subroutine, although 
none are required. Parameters may be passed by either value (ie., the 
integer value of the variable in the POWER BASIC program) or by 
address (ie., the address where the variable is stored in POWER 
BASIC)-. A variable is passed by value ;*en the variable itself is 
entered as a parameter (eg,, ABC, VAR, DON, etc.), and the address of 
the variable is passed when the variable is enclosed in parenthesis 
(eg., (ABC), (VAR), (DON), etc.). If the parameter is passed as a 
value, it. will be converted into a I6~bit two's complement integer. If 
passed by address, the 1 6-bit address of the location in memory where 
the variable is stored internal to POWER BASIC will be passed, and a© 
variable conversion will be performed. Parameter passing by address 
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enables the user to access both floating point and dimensioned or 
array variables from the assembly language subroutine, knowing that 
each, variable or array -element is 6 bytes in length. The user should 
refer to Section 3, paragraph 3. 7*6 for detailed information on the 
internal integer and floating point variable formats used in POWER 
BASIC- 

The CALL statement internally performs a "BL" assembly instruction to 
access the users assembly language subroutine. The parameters of the 
CALL statement are passed in Registers 4; 5*, 6*, and 7 of the POWER 
BASIC workspace pricr to execution of the ''BL ^ instruction. The user 
nay then directly access these parameters from his assembly language 
subroutine. The return address is contained in R11 of the POWER BASIC 

workspace. 

» 

Since a "BL" instruction is used, the assembly language subroutine may 
use only registers 4, 5, 6, and 7 of the POWER BASIC workspace. If 
other registers than these are modified within the assembly language ' 
program, values expected by POWER BASIC will be destroyed, and 
unpredictable results may occur when returning from the assembly 
language routine. Therefore it is suggested, that the assembly 
language routines supply their own workspaces. Typically, this is 
done by performing the following sequence immediately upon entering 
the assembly language subroutine: 

» 

* ENTRY POINT TO. THE ASSEMBLI LANGUAGE SUBROUTINE 
» 

SUBR1 EQU $ 

BLWP §SUBR1Z GET OWN WORKSPACE 

B 'Rll RETURN TO POWER BASIC 

» TRANSFER VECTOR. 
» 

SUBR1Z EQU $ 

DATA WRPTR WORKSPACE POINTER 

DATA START PROGRAM COUNTER 

» START OF ASSEMBLr LANGUAGE SUBROUTINE 
START EQU $ 



^TWP RETURN FROM ASSEMBLY SUBROUTINE 

The CALL statement is one of the statements having the same form, but 
its function is slightly different on the Host POWER BASIC 
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Interpreter, than in an application program configured into the Target 
POWER BASIC Interpreter. The address paraffiete* is used by the Host 
POWEB BASIC Interpreter to access an assembly language routine which 
has been loaded into a specified memory location, while the string 
constant parameter is used by the POWER BASIC Configurator and TX990 
Link Editor to appropriately link the assembly language subroutine 
into the customized Target POWER BASIC Interpreter. The differences 
in the use of the CALL statement between these two POWER BASIC 
Interpreters will be presented below. 

Host POWER BASIC Interprets^: 

To access an assembly language subroutine flrom the Host POWER BASIC 
^ Interpreter, the user must load the object program from either 

cassette or a diskette file. To load an object module using POWER 
BASIC, the user must load and execute the POWER BASIC -Object Loader. 
This program is presented in the POWER BASIC Object Loader Application 
Note available from your distributor. This BASIC program will 
appropriately load an object file from either cassette or diskette 
beginning at the specified load point entered by the user. 

When the Host POWER BASIC Interpreter is initially executed, it 
automatically sizes the contiguous RAM area from the top of 
Interpreter up to memory address hex F800 and allocates all available 
RAM area to the -BASIC Interpreter for variable and BASIC program 
storage. However, a small area of RAM must be available for the 
object program and its associated workspace. To provide this area, 
the user must execute the "NEW address " command immediately after 
executing the POWER BASIC Interpreter before loading any POWER BASIC 
programs. The address will specify the upper memory limit to be 
used by the POWER BASIC Interpreter. The user may then load the 
f^ object program into RAM at an address above this limit. The user nay 

then execute a CALL statement to this address to execute his assembly 
language subrsutine. 

Target POWER BASIC Interpreter: 

Any assembly language subroutines CALLed by a BASIC application 
program (which is to be configured into a Target POWER BASIC 
Interpreter) will be included into the final Target BASIC Interpreter 
by the configuration process. When the POWER BASIC Configurator 
encounters a CALL statement during its scan of the application 
program, it will interpret the ste-ing constant as the FILE NAME and 
ENTRX POINT of the object module being referenced, and will issue an 
"INCLUDE" statement for that object module in the Link Control File 
which it produces. The string constant may consist of up to six 
alphanumeric characters, the first of which must be alphabetic. This 
=^®® °"3^ correspond to both the ENTRY POINT and FILE NAME of the 
object module being referenced for correct inclusion by the 
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Configurator and Link Editor, The Foraat of the INCLUDE statement 
will be as follows for each object module CALLed by the BASIC 
application programs 

INCLUDE DSC22X2QCCXX/OBJ 

where: 

2SXXXX is the string constant used in the CALL statement 

The TX990 Link Editor will then appropriately include the specified 
object modules from diskette, and the assembly language subroutines 
wUl be linked with the final Target POWER BASIC Interpreter object 
module/ 

Note that the user must have the object module located on 
the diskette under the specified file name (with the "/obJ" 
extension) , and this diskette MUST be located in disk drive 
2 of the FS990 system before Link Editor is called into 
execution. 

The user must separate his workspace and data areas from the body of 
ail assembly language subroutines since all assembly language 
subroutines will be included in the final Target POWER BASIC 
Interprets*, and this final object, module will be placed in ROM for 
execution in a •TM990 board, system. Therefore, a small amount of RAM 
area will need to be allocated for the workspaces and data areas in 
the final TM990- target system. The Target POWER BASIC Interpreter 
during Power-up RESET will size for all available RAM area in the 
TM990 board system, starting ttom memory address hex FFFF<^down. All 
available contiguous RAM area will then be assigned to the BASIC 
Interpreter for variable storage. Therefore the user must supply a 
non-contiguous block of RAM in the TM990 board system for use by the 
assembly language subroutines. 

Exampleis : 

200 CALL "CONVERT", OB800H,7AL,0PB,LWP 
200 CALL "INCUT", 0C8O0H,ST,(VAR), (NAM) 

The first example will branch and link (BL) to the subroutine 
"CONVERT" at location hex B800 with the 16-bit two's complement values 
of the variables VAL, UPB, and LWB passed in registers 4, 5, and 6. 
If executed on the Host POWER BASIC Interpeter, the assembly language 
subroutine must be loaded so that its entry point is at hex address 
BSOO^g.. If configured, the corresponding object module should be 
located in the- file "DSC2: CONVERT/ OBJ" to be correctly included by the 
Link Editor.' The second example will branch and link to the 
subroutine "INCUT" at location hex C800,g-. The l6-bit two's 
complement value of ST will be passed in Register 4, while the memory 
address of the location of the variables VAR and NAM will be passed in 
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registers 5 and 6, respectively. 

5.15 FILE MANAGEMENT 

The Host POWER BASIC Interpreter provides a convenient method of 
perferaing file I/O to the devices and diskette files of the TX990 
Operating system via its file management package. The Host POWES 
BASIC Interpeter supports a minimal but sufficient set of file 
primitives to SA17E and LOAD BASIC programs, and read and wite binary 
data. The SAVE and LOAD Commands were discussed in Section 4, while 
the remainder of the file' primitives will 'be discussed below. 

^ 5. 15.1 PATHNAME SYNTAX 

Most all POWER BASIC file control statements use a pathname to 
indicate a device/file referenced by that statement. All TX990 
pathnames used by POWER BASIC adhere to the following rules: 

All device pathnames consist of a one- to four- character 
device name assigned to that device during system generation. 
Typical device pathnames are DSC, DSC2, LP, CS1, and CS2. The 
user must reference his system generation for the device names 
used in his particular TX990 Operating System. 

All diskette file pathnames consist of one to seven characters 
separated from the device name by a colon (-:). The first 
character must be alphabetic (A-Z); the rest may be 
alphanumeric. The file name is followed by an extension to 
the file name, which is one to three characters separated tfom 
the file name by a slashC/). The first character must be 
alphabetic; the rest must be alphanumeric. The file name and 
extension are specified when the file is created by the BDEFS 
or BDEFR POWER BASIC statements. Typical valid diskette file 
names are DSC2: LOAD /ONE, DSC:PROGRAM/TU, and .-TEMPER/Dll. 
Invalid diskette file names would be DSC: TEMPERATURE/ SNC — 
too many characters, DSC2:FAN0N/920 — first character of 
extension must be alphabetic, and DSC: MOTOR/STEP — extension 
too long. 

The POWER BASIC/TX990 interface checks the syntax of all file and 
device pathnames when the BASIC statements are entered. If the 
pathname syntax is not legal, an INVALID PATHNAME error will result. 

5.15.2 BDEFS STATEMENT 

The BDEFS statement will define a sequential diskette file on the 
specified device and with the specified file name and extension. The 
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BDEFS file primitive is a POWER BASIC stateaent; however, it is 
typically only executed in the keyboard mode (without a statement 
number)-, and is not entered into a BASIC program since each execution 
of the program would attempt to redefine the file. Attempts to define 
a file which already exists will result in a TX990 error. 

Form: 

BDEFS pCstring constant>l 

The <string constant^ or <string variable> specifies the pathname of 
the diskette file to be defined. 

The file is placed in the diskette file directory, but the file is not 
•"known" by POWER BASIC until the file is opened by the BOPEN ^ 
statement. 

The logical records in a sequential file must be accessed in a 
sequential manner (ie., record 1 must be processed before record 2, 
etc). When a sequential file is closed (via th.e BCLOSE statement 
following an access), the position of the last access to the file is 
saved. When the file is open again (via the BOPEN statement), the 
next I/O operation accesses the next logical record in the file, 
instead of the first record of the file. To' access the first record 
of the file, the' user must execute the RSSTOR #<var> statement to 
rewind the file to its beginning. 

Sequential files in POWER BASIC are exclusively opened for read only 
cr write only operations. The access type is specified by the first 
read or write to that device/file, and thereafter the file is defined 
as either a read only or write only LUNO. The user cannot write to a 
file and then attempt to read values from the file without first 
closing the file after the write via the BCLOSE statement, and vice ^ 
versa. Attempts to read a sequential file opened for write or to 
write a sequential file opened for read will result in a INVALID FILE 
ACCESS error message. Also note that the last write operation to a 
sequential file defines the current end of file. 

Examples: 

BDEFS "DSCasRELAI/SEQ" 
BDEFS "DSCjMOTOR/CNT" 
BDEFS "DSC:VALUE/OPN" 

5. 15". 3 BDEFR STATEMENT 

The BDEFR statement will define a relative record (random access) 
diskette file on the specified device and with the specified file name 
and extension. The BDEFR file primitive is a POWER BASIC statement; 
however, it. is typically only executed in the keyboard mode (without a 
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llllZ 5 fu^''^ ^"""^ ^ """^ ^"^^^'^ ^^° a BASIC program si^ce each 
S Sof^^ °^^® \'?®'^ '^^^ ^^^^=P^ ^ redefine the file. Attempts 
to defile a file which already exists will result in- a TX990 err-or 
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BDEFJlp:string 'eonstantjri 
Y<string variableV 



Jhe file is placed in the diskette file directory: however th« f^i* 
slaJeL'T'''^'' "" '°"^ ^^^' "°^^^ ^^« ^^^ iVSeneTby Ve^BO^EN 



a? a ii!^n mes are. supported only on diskette. The beginning 

?L r,^\*r^ '^^''"* ^^^* ^* specified by logical recort 0; the enfSf 
the ^lative record file is specified by the highest nuabired logical 

they may be accessed for- both read and write operations. That is th^ 

SeVXr^' ? "^""^ "°' '^"° immediately wr'ite a record w"thoSt 
performing a close operation between them. 

fiS L'^olii7o..T?'^-P? -^ °P^°^^ ^^^ ""^^ BOPEN statement, the 
file IS positioned to its beginning (logical recorri number of 0). r^e 

^nner until the highest record number is reached. After a read o- 
Zi^ opejation, the logical record number is app ropriTtely 
iacr^ented by the number-of bytes read or written. The L7r a^y a'so 

statement. The user-will specify the record length, logical record 

^ SaTy f IIH" ^i^P^^«;r"' ^^^^^^« ^^^ ^««^ When eSerlng thi 

BINAHY 4 statement. The file will then be positioned to that 

SK^tfif«.T®'^.¥? ^^^ ^^^^ ^^^ ^^^^- The next read or write 
nay then access this "random" position within the fiio 5„k 

llTAl¥^2%Mllik?r rf^°» °' 3e.u?ntTa\'t" ?he/'o'n^iy flteT 
BINARI 2 or BINART 3 statements ar^ executed, the next record in the 

3i?faTn«S^r°®^^?*^* ^®° another BINARY 4 statement is executed 
With a position value out of sequence, the access is at "random". 

Examples: 

BDEFR "DSC2SGATE/REL" 
BDEFR "DSC J SWITCH/ ACT" 
BDEFR "DSC:TIME/MpN" - 
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5-. 15.4 BDEL STATEMENT 

The BDEL statement will delete the specified sequential or relative 
necoiti file from the specified diskette. The BDEL file pristitive is a 
POWER BASIC statement; however;' i't: is typically only executed in the 
keyboard mode (without a statement number), and is not entered into a 
BASIC program since each execution of the program will attempt to 
delete the specified file. Attempts to delete a file which does not 
exist will result' in: a 1X990 eiror; 

Form: 

SDEL jVstring constant>|- . . 
A ^string variableV. 

The <string cons tan t> or-<string variable> specifies the pathname of 
the diskette file to be deleted. 

The BDEL statement deletes the file name from the diskette file 
directory, and subsequent references to this file name will result in 
a undefined file name error. The specified file must be closed bei'ore 
deletion. Attempts" to delete a file which is opened will result in a 
TX990 error^ 

Examples: 

BDEL "DSCjMOTOR/CNT" 
BDEL "DSCasGATE/REL" 

5-. 15-. 5 BOPEU STATEMENT 

The BOPEN statement will open the specified device/file fo r sequential 
or relative reconi access depending upon the device/file type. Most 
devices (such as the 733 ASR/KSR keyboanl/Pr inter, line printer, and 
733 ASR Cassette Unit) may only be opened for sequential access, while 
diskette files will be opened according to the file type as defined by 
the BDEFS or BDEFR statements. Note that if a diskette file is 
specified- as the pathname of the BOPEN statement, the file' must have 
previously been defined by the BDEFS on BDEFR statements. 

•The BOPEN statement will place the specified file name in the 
operating system and in the POWER BASIC file directory. Until an open 
operation is executed, devices/files are not located and file 
management operations to manipulate them cannot be initiated or 
performed. The BOPEN statement causes the device/file to be assigned 
solely to the calling prxsgram until a BCLOSE statement is executed on 
the device/file. That is, no other BASIC prsgram may access the 
device/ file until it is prsperly closed. 
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Forb: 

^string c©nstant>l 
^ia# niaaberj BOPEN (4Striag variable>3, <numerie variable> 

The 4striag eonstaat> orotring variable^ specifies the pathname of 
the devioe/file to be opened. A logical unit number (LUN-0) is 
assigned to the deviee/file name when it is placed into the POWER 
BASIC dii^etory. This LUNO is then returned to the user in the 
^numeric variable>. The numeric variable (LUITO) is used in all 
future file management opemtions when referencing the the device/ file 
(e.g., the COPY ^numeric variables TO ^numeric variable> and BCLOSE 
<g»meric variably). 

^ The file is opened for either read and/or write. A relative reconJ 

file will be open for- both read and write; that is the file may be 
both written to and read from without closing the file between 
operations. However, a sequential file will be opened exclusively for 
read only or for write only depending on the type of the first access 
to the file after it is opened. 

Note that user- may only have up to 4 device/file LUNO»s opened at one 
time. If mom than 4 devices/files are attempted to be opened, a 
TABLE &RE& FULL en'or will result. 

The BOPEN statement perforas only an open operation. That is, it- does 
not rewind the device/file to its beginning before returning to the 
user. 

A relative record file is still positioned to the first logical recorl 
of the file. 

f^ A sequential diskette file, when closed following an access, saves the 

position of the last access to the file. When the file is opened 
again, the next I/O traasfe r- accesses the next logical record in the 
file instead of the first logical record of the file. To access the 
firrst logical record after a BOPEN operation, the user must execute a 
rewind operation (via the RESTOR ikvar> statement). Typically, when 
entering values into a new file, or reading or- overwriting an 
existing file, the user executes a RESTOR statement immediately after 
opening the file and before performing any I/O operations to that 
diskette file so that subsequent accesses will begin with the first 
record of the file. 

If the specified device/file is the T33 ASR cassette unit, the user 
will need to perform a RESTOR operation on the cassette device if the 
first record of the tape is to be read ft'om or- written to. 

The BOPEN statement is typically used in both the keyboard mode 
(without a statement number) and in POWER BASIC programs. In the 
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keyboard mode it is typically used to open the devices/files used by 
the COPY stateoent; while in a program, it opens the devices/files 
used in BINARY statements. -r 

Examples : 

BOPEM "DSC2 : FILE 1 /SRC , FIL 

RESTOR #FIL 

BOPEN "LP", LP 

COPT FILE TO LP 
SO DIM A(5) 
60 $A(0)s"DSC:FAN/TST" 
70 BOPEN $A(0),FAN 
' 50 RESTOR #FAN 
90 BOPEN "CSI^jCSO 
100 BINARY 1,FAN,80;3,VAL(0) 

5.15.6 BCLOSE STATEMENT 

The BCLOSE statement will close the specified device/file. The BCLOSE 
statement removes the device/ file from the POWER BASIC directory, 
releases the assigned, logical unit number (LONG), and releases the I/O 
device and the file on the medium of the I/O device from the POWER^ 
BASIC Interpreter. 

Form: 

[line number^ BCLOSE cnuneric variables 

The numeric variable specifies the logical, unit number (LUNO) that 
was assi®aed. to it by the corresponding BOPEN statement. 

The BCLOSE statement will perform a straight close operation if the 
specified file was opened and read from, but not written to. The 
close operaticn is as explained above. 

The BCLOSE statement will perform a close with end-of-file (EOF) 
operation if the file was opened and written to. It will perform a 
close operation as previously described above, followed by a write EOF 
operation. When the device specified is the keyboard/printer, the 
printer- performs three line feed operations. When the device 
specified is the 911 or-913 VDT, only the close operation is 
performed. When the device specified is the line printer; the printer 
performs a form-feed operation. When the device/file specified is a 
sequential diskette or cassette file, the EOF sequence is output at 
the current position of the file. When the device/file is a relative 
record diskette file, the EOF sequence is output after the last record 
of the file. 
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BOPEN "DSC jMOTOR/SRC" ,M0T 

RESTOR #MOT 

BOPEN "CS1",CS0 

RESTOR #CSO 

COPY MOT TO CSO 

BaOSE MOT 

BCLOSE CSO 

10 BOPEN •'DSC2:DATA/BIN«,DAT 
20 RESTOR #DAT 

30 BINARI 1,DAT,80j3,VAL(0) 

^0 BCLOSE DAT 

70 BOPEN «LP",I 

90 BCLOSE I 



5.15.7 RESET STATEMENT 



Tiie RESET statement will oi^e^ /< r r 

deviee/file names ^^ill hi rLJrl^ % ^v. °P*° devices/file^ 

logical «airSS)e« (LTOO^sr^if T '^^ °°"^ ®^^^ ^^'-^^^o 

Will be released f^mSe poiSrbast'^t^"^'' ^°' '^" '^^^=^ 
statement has no parametere Interpreter. The 



■ ^. For®: 



i U^B nuabe^ RESET 

The HE3ET statement will perform a straight .1 
devices/files which we. op/ned an^ o^lTSfd V.^^ an^l lo^w 

• Section Van re:rcesf^^^^^^^ ' ^^°- ^^^^ end-of-fii. 

to the BCLOSE statement fo'rat'Sora^^ ""' T"'^ ^^• 

operation. ""^ lor an explanat\on on the close wi- 

Examples; 

BOPEN "DSC2;VALUE/FIN«,SRC 
RESTOR #SRC ' 
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BOPEN "DSCj7ALUE/FIN«,DST 

RESTOR #DST 

COPY SRC TO DST 

RESET 
10 BOPEN "DSC2:PARM/REL",PAR 
20 RESTOR #PAR 
30 BINARY 1,PAR,16;2,NDM(0) 
60 BOPEN "LP", J 
90 RESET 

5.15.8 COPY STATEMENT 

The COPY statement allows the use r- to copy one file on a specified 
device to another device/file. The COPY statement is useful for 
baeking-up, expanding, pjlating, o r concatenating cassette or diskette *% 
files , 

Fonat 

[line number^ COPY <nvuner±c variable. 1> TO <numeri.c variable 2> 

The file specified by <numeric variable 1> is copied into the file 
specified by <numeric variable 2>. The <numeric vari.able> specifies 
the logical unit number (LUNO) that was assigned to a particular 
device/file by. the corresponding BOPSN statement. This format 
requires that both files must be defined and opened prior to execution 
of the copy statement. 

When copying files, both devices/files must be of the same file type, 
tht is, both sequential or- both relative record. If a sequential file 
is attempted to be copied to a relative record file, or visa versa, an 
INCQMPATABLE FILE TYPE error will result. 

Examples: 

BOPEN "DSC2 : PROCESS/SR 1 " , S 1 
RESTOR #S1 

BOPEN "DSC2:PR0CESS/SR2",S2 
RESTOR #S2 

BOPEN "DSC2 J PROCESS/SRC" ,SRC 

RESTOR #SRC 

COPY SI TO SRC ICOPY PART 1 

COPY S2 TO SRC ! APPEND PART 2 - SATE PROGRAM IN SRC 

RESET 

BOPEN "DSC2: PROCESS/SRC", SRC 
. RESTOR #SRC 
BOPEN "DSC ; PROCESS/BCK" , BCK 
RESTOR tfBCIC 

COPY SRC TO BCK ! BACKUP PROGRAM 
RESET 
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10 BOPEN ••DSC2;SAMPLES/TST'',SMP 

^ BO S^.LP^LP '^^^ ^^2 ^2 ^ B 

; 100 rSL"^ ^ "-^ -^^^ S^LE FILE TO LP 

' 110 STOP 

The COPI statement may also ho .leow <.^ 

files as follows: ^ ^° expand sequent: 

i« fS?^ DSC2:PR0CESS/TMP 

2? B^E^ ^^ ^DISKETTE FILE DSC2:PR0CESS/TST 

e« BOPEN "DSC2: PHOCESS/TST" , TST 

30 RESTOR # TST 

^0 BOPEN "DSC2:PR0CESS/TMP", IMP 

fO RESTOR # IMP 

60 COPI TST TO IMP 

70 BCLOSE TST 



5.15.9 BINARY DATA I/O STATEMENTS 

SL?/:^i the sVeriS:rLiref.Lr%T -^ -^^^^ °^ ' 

f^om the device/file into^'u^^^^^^^^^ °^^^ ^^^'^ ^^ 

values from successive vL^oh?! variables, or may • 

device/file The bvt! ^^^^^^^^ expressions to the s 
values wi^hio conv^sion ^?. ^^^r^"" °^ "^"^«« ^^ 8-1 
values on thf sp'SISS S;vic^/mT '" ''"''"^ "^' ^^^^^^^ 



r;fe /krorA U^rfL- ff^c^ ^^s 
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There are four forsas of the BINARY statement. They are used to 
specify the number-of bytes to be transferred (BINARY 1), write an 
assigned number of bytes from each succeeding expression to specified 
device/file (BINARY 2), read an assigned number of bytes from 
specified device/file into each succeeding variable (BINARY 3), or 
specify the position within a relative record file (BINARY 4). 

The general fora of the BINARY statement is as follows: 

Qline number] BINARY <exp>,<arg>,<arg>, <arg> 

where 

<exp> specifies the type of BINARY operation to be performed 
<arg> are the arguments of the particular BINARY operation ' 

The four-fonns of the BINARY statement will he explained in detail in 
the following sections. 

Several BINARY statements may be concatenated into a single BINARY 
statement on one line by separating all succeeding BINARY statement 
<expressiOT3s> and <arguments> from the preceeding BINARY statement 
with a semicolon (;). Note that the "BINARY" statement name will 
appear only as the first statement of the line, and will not appear 
before subsequent BINARY statement <expressions> and <arguments>. 

Example : 

10 BOPEN "DSC: FILE/SRC", FIL 

20 RESTOR #FIL 

30 BINARY 1,FIL,6 

40 BINARY 2,A,B 

50 BINARY 3,VAL,7AR 

could be concatenated into a single statement as 

10 BOPEN "DSC: FILE/SRC", FIL 

20 RESTOR #FIL 

30 BINARY 1,FIL,6;2,A,B|3,VAL,VAR 

Concatenation of BINARY statements is required when more or less than 
6 bytes are to be read or written ft'om the device/file. This is 
required since execution of the "BINARY" phrase (of any subsequent 
BINARY 2; 3, or- 4 statements) resets the number of bytes to be read or- 
written to 6, the typical default byte length since all POWER BASIC 
variables and array elements are 6 bytes in length. 
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Example: 

10 BOPEN "DSC2: FILE 1 /SRC, FIL 
20 RESTOR #FIL 

30 BINARY 1,FIL,80 isET # OF BITES TO 80 

SO Sf2v H^^rll l*»«WILL READ ONLI 6 BYT 

50 BINARY 2,0UT(0) !»«»WILL WRITE ONLY 6 BY 

the correet form would be 

10 BOPEN "DSC2:FILE1/SRC\FIL 
20 RESTOR #FIL 

30 BINARY 1,FIL,80;3,REC(0^;2,0UT(0) -'WILL CORRECTLY READ & ^ 
§.15.9.1 BINARY 1 STATSffiNT 

^e BINARY 1 statement specifies the logical unit numh^v.- n 
IT^t'^oVaill?' per- device/file access'^o'^eaf ^rSTorw^ 
that LONO for all subsequent BINARY stateaents. 

Fera: 

Cline aufflbefj BINARY 1, <numeric vailable>, <exp> 

^iJi" 5 L ^"^^ ^^^ subsequent BINARY operations s- 
perforaed. The LUNO is the number which is ass^'saed to the s- 
jariable when the device/file is opened wili^the BOpIn d 
rfp'r^s^ntf Sf ?^SQ^f , ^^^^eaent, the specified variabU c 
i?WA?T?^!t the device/file pathname, and this variable is use 
BINARY statement. The BINARY 1 statement assigns the BINARY L 
use by all subsequent BINARY statements. ^ 

Si sSA^Y^nSn^^^^ the number-of bytes to be read from or wri 
sSt!S^! ^™°/'=»'r^°fe subsequent access by the BINARY 2 or ! 

BINARY statement. Execution of the next BINARY statement wi" 

lelsThlTf hT"" '" ^' T^«^^«^ i« applicati^s wha:^'- 
less than 6 bytes are to be read or-written for- each access i 

Sf temSf ^f S '^^ ^^f^ f T ^^'-^^ 3 statements to the'a 
statement via the semicolon (;) separator. 

Example: 

10 DIMA(IO) 

20 BOPEN ''DSC:MOTOR/CNT",MTR 
30- RESTOR #MTR 

30 BINARY 1,MTR,66|2,A(0) I WRITES 66 BYTES TO FI 
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10 DIM Ado) 

20 BOPEN "DSC:MOTOR/CNT",MTR 

30 RESTOR #MTR 

40 BINARY 1,MTR,66 :; BINARY 2,A(0) lONLY WRITES 6 BYTES TO FILE 



Example: 



10 BOPEN ''DSC2sTEMPER/SMP",TEM 

20 RESTOR #TEM 

30 BINARY 1,TEM,6 I SPECIFY FILE FOR 6 BYTES/ ACCESS 

40 BINARY 3,TM1,TM2,TM3,TM4 'READ FOUR 6-BYTE DATA VALUES 

5.15.9.2 BINARY 2 STATEMENT 

The BINARY 2 statement writes an assigned number of bytes from each 
succeeding expression to the BINARY LUNO. The BINARY LUNO and number 
of bytes are assigned by the BINARY 1 statement. 

Form: 

Qliae numbe^ BINARY 2, <exp> [|,exp] .... 

i. 

The <exp> of the BINARY 2 statement specifies the expression or 
variable values to be written to the BINARY LUNO. 

The BINARY LUNO is assigned by the most recently executed BINARY 1 
statement. The number- of bytes to be written is also assigned by the 
BINARY 1 statement if the BINARY 2 statement is concatenated with the 
BINARY 1 statement via the semietjlon separator- (eg . , BINARY 
1,FIL-,20;2,7L1(0),L2(0) will write 20 bytes fnsm each of the variables 
VL1C0) and L2(0)>. If the BINARY 2 statement is a separate statement 
entry, the number of bytes to be written is reset to 6 (eg., BINARY 
2,^1,7L2 will write 6 bytes from the variables VL1 and 7L2). 

Example: 

10 DIM Ado) 
• 20 BOPEN ''DSC:STRING/CHR",CHR 
30 RESTOR #CHR 

40 $A(0)='»STORE THIS CHARACTER STRING INTO FILE" 
40 BINARY 1,CHR,66;2,A(0) 'OUTPUT STRING 

This example will store the character- string $A(0) into the file 
"DSCrSTRING/CHR". Note that string variables are placed in the BINARY 
statements as numeric variables, not string variables. This is 
because all variables are output directly without regard to either 
numeric or- ASCII content. 
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10 BOPEN ''DSC2:DATA/SQR",SQR 

20 RESTOR #SQR 

30 BINARY 1-,SQR,6 

^0 BINARY 2,I,I»I,SQR(I) 

50 NEXT I 

_ , 5". 15-. 9. 3 BINARY 3 STATEMENT 
r^ "^^^^^^^^ 3 stateaent reads from the BINABY tttoh ,« «« • 

Bun**.- of bytea are assigned by the BDJABI 1 statement 

Forms 

Oiae nufflber] BINARY 3, <variable> <, variable :.'. . 

Simple or dimensioned numeric va;ilbles ^^^°' ''^"^ °^^ ' 

' TtltS^nt^ LUNO- is .assigned by the most recently executed 

statement. The number of bytes to h<a r.o«w <» ^^ execjwea 
BINARY 1 statement if ?he BBIjiY 3 statement -/^^^ assignee 
BINARY 1 statement via thl LL , ^ "^ concatenated 
nFIL,40j|-,?Au5rwill read UO ?vV°^°^^ ^«S., 

the BINARY 2 statement is a seclL St!, 'f'^^ ^?^ variable 7AL( 
^ bytes to be rSd is re^/f ?« % f statement entry, the nu 

bytes into each'o'f 'L^J^JL' ^'^'^, 'Z^'' ''' ^^^^ -^^^ 



10 DIM CHS(II),SET(H) 

60 ^lkf'-^°'^'^^°^ jWag 30 BITE 7UDES FSOM 

100° S'^^l]'"''''^''' '^ 30 BYT^ VALOSS INTO 
1 10 ' RESET 
120 STOP 
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statement 50 of this program writes the character set in $CKR(0) to 
the file •'DSC2:CHAB/SET". Note that the string variable ($CHR) is 
specified as a numeric variable (CHR) vrtien referenced in the BINARY 
statement. It writes 30 characters, including 26 characters of the 
character- set plus the terminating null. Since this is a sequential 
file, and it has been written to, the file must be closed before it 
can be read from. Statement 60 perforas the close operation, while 
statement 70 opens the file so the data values may be read. Statement 
90 reads the 30 chaiactere saved in the file into the numeric variable 
SET(O). Again a numeric variable is specified in the BINARY statement 
instead of a string variable. Statement 100 then prints this 
character set as a string, $SET(0). 

5-,15.9.1» BINARY 4 STATEMENT 

The BINARY 4 statement allows the user- to access a given byte position 
within a relative record diskette file. A file is defined to be 
random access by the BDEFR statement when the file is created. The 
BINARY LUNO is assigned by the BINARY 1 statement. The number of 
bytes specified in the BINARY 1 statement has no effect on the BINARY 
4 statement. 

Fom: 

. giae number] BINARY 4 v<expl>,<exp2>.,<exp3> 
where 

<exp1> specifies the record length 

<exp2> specifies the reco ni numbe r- 

<e3cp3? specifies the byte displacement within the reconl 

The BINARY LUNO is assigned by the most recently executed BINARY 1 
statement . 

The record length specified by <exp1> is the byte length as determined 
by the user. A recorxi may consist of a single variable or collection 
of variables as reqxiired by the application. 

The record number specified by <exp2> indicates the record 
displacement within the file. The valid range for-<exp2> is ft'om 
thrau^ the last record of the file. Record number is the first 
record of the file'. 

The byte displacement specified by <exp3> indicates the byte position 
within the reconi specified by exp2 . The valid range for<exp3> is 
from through the record length specified by <exp1>. A byte 
displacement of indicates the first byte of the record. 
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1 

POSITION . fHEeORD LENGTH • SECOSTO NOMBSa ) ♦ BTTE BISPLACEMH 

expaad the relative record file and the last record written „ 

^t^oTeirorrA.'tVir''' ^^^ °^ ^^^^- ^'' --^'s^e'tw^en'- 

- ' i^o Via ?heiT?f?TT ?^. ^""'r^ end-of.fiie, even if not writ 

I?ff«Ji ? BINARI 2 statement,. will be included in the fi: 

^ L fehif *^P^^;^^^«° P^^t the end of file on a i^Ltive «cord f 

t?ror ii.?f "^"^f ''^ ^^* 2^NARI 3 statement will resul? ^Zu'^ 
trror. Attempts to position a sequential file via the aSaVv 
statement Will result in a POSITION E?ROR message ^^^^^ 

Examples; 

BDH^ »SSC2.FILE1/REL« lEITTERED IN KEYBOARD MODE 

10 BOPEN "DSC2:FILE1/REL",FIL 
20 RESTOR #FIL 
30 FOR IsI'tO 100 

50 N^fl ^'^^'^'2.I,SQR(I), 1*1,1 3 
60 INPUT "RECORD NUMBER "|NUM 

S !J?S;V'^'*'^'°?2,I,SQI,II,III 
80 PRINT I,SQI,II,III 

90 INPUT "ANOTHER RECORD? (I or N)": $M 

^em^ lOO IF $M s "I" THEN GOTO 60 

' 110 BCLOSE FIL 

120 STOP 

This example defines a relative record file "DSCS-fttpi/pttt n , ^ ^u 
writes the values of I SORri) t»t T«h t i: j^^^^.FILEVREL", and th£ 
file outBufeii^t fi tZ J' ^' ^°^ ^ 3 for Irl to 100 into ti 

uTer'tTrTllt^ , ^^^^^ ^°'' *^^^ ^^^"« written. It then asks ti 
aser ior a particular record number within +-h^« ^^^l ^ i.J^ 

appropriately positions within thl ^^\^ } i ^^--' ^°*^ *^« 
iralues of Interest started with the first byte of the recoris 
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5-. 15.9.5 EXAMPLE PROGRAM 



The following example program illustrates the use of the BINARY 
statements in an account ledger entiy and display application. 

BDEFS "DSCajACCOUNT/LDG" I ENTERED IN KEYBOARD MODE 

10 DIM DAT(1),NAM(3) 

20 BOPEN ''DSC2sACC0UNT/LDG",LDG 

25 RESTOR #LDG 

30 PRINT §"0"; "ACCOUNT LEDGER DATA ENTRY" 

40 LIM s 500 ISET CREDIT LIMIT TO BE $ 500 

49 REM 

50 REM - INPUT VALUES AND PERFORM CALCULATIONS 
. • •51 ' REM 

60 INPUT "INPUT DATE (MN/DY/YR) ",$DAT(0) ' 

70 INPUT "INPUT NAME ",$NAM(0) '^ 

80 IF $NAM(0)="9999" THEN GOTO 120 . 

90 INPUT "PREVIOUS BALANCE s ";PRV|" NEW AMOUNT s ";AMT 

100 BALsPRV+AMT IBALANCE s PREVIOUS 3AL + NEW AMOUNT 

110 CRLsLIM-BAL 'CREDIT LDIIT s LIMIT - BALAI4CE 

1 19 REM 

120 REM - OUTPUT DATA, NAME, PRV,. AMT, BAL, AND CRL TO BINARY FILE 

121 REM 

130 BINARY 1,LDG,12;2,DAT(0)t:BINARY 1 ,LDG,24;2,NAM(0) 

140 BINARY -2, PRV, AMT, BAL, CRL 

150 IF $NAM(0)="9999" THEN GOTO 170 

160 PRINT Si PRINT "MORE? (ENTER 9999 FOR NAME IF DONE) ":: GOTO 70 

170 BaOSE LDG ! CLOSE FILE WHEN THROUGH WRITING 

180 BOPEN "DSC2:ACC0UNT/LDG",LDG lOPEN FILE TO BE READ 

185 RESTOR ^DG 

189 REM 

190 REM OUTPUT HEADER ON PRINT DEVICE OR AT TOP OF SCREEN 

19 T REM _ 

200 PRINT §"C«:: PRINT ^ 

210 PRINT TAB(36)|"PREVIOUS";TAB(46)j"PURCHASE"j 

220 PRINT TAB(58);" NEW "; TA3(69); "UNUSED" 

230 PRINT "DATE" JTAB( 12); "NAME" ;TAB(36) J "BALANCE" ;TAB(47); "AMOUNT"; 

240 PRINT TAB (58) J "BALANCE"; TAB (69); "CREDIT" 

249 REM 

250 REM - INPUT BINARY VALUES FROM FILE 

251 REM 

260 BINARY 1-,LDG, 12^ 3,DAT(0) :: BINARY r,LDG,24;3,NAM(0) 

270 BINARY 3, PRV, AMT, BAL, CRL 

279 REM 

280 REM - OUTPUT DATA VALUES 
281. REM 

290 IF $NAM(0)="9999" THEN GOTO 330 

300 PRINT $DAT(0);TAB(12);$NAM(0);TAB(36); 

310 PRINT #"$,$$$.99E";PRV;TAB(46);AMT;TAB(57);BAL;TA3(67);CRL 
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320 GOTO 250 
330 BCLOSE LDG 
340 STOP 



This pTOgraa requests the user to enter feh« ^»> 
balance, and new purchase amount: Tf ?», f® ^^^^' °^®- 

the binary file 'DsSncSuNT;LDG« ''it contTn '"'f " 
inputs, until the user- enters a ♦^999 q« i„ 1.°^°^^°?^ J° ^^ 
PTOBipti the pregraia th«n J.A . response to the "3 

field) is encounterS! ^ ^""^ ^* end-of-file ('.9999" i 

r<- '■■■ Execution of the previous program would orodueo fw^ ^ m • 

^ . , i -^i user. responses are under-lined. P^duce the followini 

am 

ACCOUNT LEDGER DATA ESfTSr 
I INPUT DATE (MN/DY/YR) ; 11/10/78 

INPUT NAME t JOHN DOE ^ 
PREVIOUS BALANCTTW NEW AMOUNT r _t25 

MORE? (ENTER 9999 FOR NAME IF DONE) 

INPUT NAME : JANE SMITH 
PREVIOUS BALANCFTW^EW AMOUNT r 250 

^°?MLi^^ 9599 FOR NAME IF DOlffi) 
INPUT NAME : 9999 

^ 11/10/78 JOHN DOE f 100 L *^S^^. ^^^^^^ CRE 

■ V ; 11/10/78 JANE SMITH | ^S?]?? t '^^'o Ullfo | f? 

- : : STOP AT 340 
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SECTION VI 
CHARACTEH STRINGS 



6-. 1 GENERAL 



ASCII character strings are stored in the same variables as are other 
POWER BASIC variables. Variables are designated as containing 
character strings by program content or semantics. Any variable or 
array may contain ASCII characters and, in fact, may be filled with 
ASCII characters and numbers at the same time. String variables are 
designated by preceding the variable name with a dollar sign. 
Otherwise, the variable is treated as a number. ASCII characters are 
stored in contiguous memory locations with a null character 
terminating the string. lou must ensure (with a DIM statement) that -^^ 

enou^ memory for a string variable has been set aside to store all 
the characters or other contiguous variables may be destroyed. The • 
following formula indicates the number of ASCII characters you may 
store in any variable or array; 

Configurable POWER BASIC 

Number of characters s 6 x (number of variable elements) - 1 

Examples: 

II 6 X 1 - 1 s 5 

Ado) 6 X 11 - 1 s 65 

N(10-,5) 6 X C11 X 6) - 1 s 395 

6.2 CHARACTER ASSIGNMENT 

When a string assignment is made the actual characters are moved to 

the new variable. --'^ 

Form: 

$ VAR s <$VAR> 

$ VAR s ''<character string>" 

Characters are transferred one by one until a null byte is found. 

Escamples: 

10 ^IIs^YES" 

20 $J0=^1 

30 •$N(4-,0) s "CHARACTER STRING" 

A character string is referred to as <$VAR> and implies either a 
literal string or a dollar sign preceding a variable. $<VAR> implies a 
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eharactar string only of the form dollar sign preceding a variable 
ASCII comparisons of the following form are valid: 

IF <$VAS> RELATION <$7AH> THEN <BASIC STATEMENT> 



100 IF $1U«T' THEN GOTO 500 

110 IF $N(I,0) s$N(J,0) THEN GOSDB 600 



An ASCII variable nay appear in a READ statemAnf <^ ^.w 

DATA statement entry is also an aIcII vS2?e or an Al?I??t?- 

When data types do not match you receive JnLrnn .^ i ,. 

©f the READ statement. you receive an error at the line nui 



10 READ $N(0),A,B,$2(0) 
20 STOP 



30 DATA "STRING DATA", ia345,A*10,$N(0) 

Se'vt^riT^fl^t^,t--tr^^^^^^ "^^^^^^ ^^^ 

Fi^ally, the ASCII v:Jllb\enzCr::e^v?s^L^^^ T4.T.t%^l] 

A dimensioned string variable can have a byte index m^. ^^o • 

Of the iSCH etrlng. UcSfirLlq'SvaleS^?, VIoT'" ""' ""* ' 
E^eample : 



^ 10 DIM A(IO) 

20 $A ( )s"ABCDEFGHIJKLMN0PQRSTUVWXY2" 

30 PRINT $A(0) 

^0 PRINT $A(0;1) 

50 PRINT $A(0j10) 

60 STOP 

RUN 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 
JKLMNOPQRSTUVWXYZ 

STOP AT 60 
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10 DIM A(10),B(10) 

20 $A(0)s"ABCDEFGHIJKLMNOPQRSTtJVWXIZ" 

30 $B(0)=$A(0;10) 

40 $A(0;2)=4B(0;2) 

50 PHINT $A(0), $B(0) 

60 STOP 

RUN 
AKLMN0PQRSTU7WXI2 JKLMNOPQRSTTmCCIZ • 

STOP AT 60 

6.3 CHARACTER CONCATDIATION • --^ 

Strisigs are concatenated by using the "+" operator. 
Form: 

$<VAR> s <$VAR> + <$VAI!>+. . . . 

Concatenation operations nay be chained together and the final string 
will automatically be terminated with a null by POWER BASIC. 

E^eample: 

10 DIM A(10) 

20 $A(0)s«ABCDE'» 

30 $A(0)sU(0)+''FG''+"HIJK'' 

40 PRINT $A(0) 

50 STOP 

RUN 

ABCDEFGHIJK 

STOP AT 50 

The following example results in a phenomenon called "CHOO-CHOO" . It 
is caused because a null cannot be found. 

10 $A(0)a''ABCD"+$A(0) 

POWER BASIC will detect this situation and terminate the string 
assignment by inserting a null when a previously stored value is 
again being selected for storage. 
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6.4 CHARACTEB PICK 

. Characters can be picked from one variable into another by using the 
■'• -assi^iaient operator. 

Fenas 

s <$?AH> , <EX?> 



fipS^SSRv 



>#PS!\ 



The expression is evaluated and the resulting number specifies the 
number ©f bytes to be assigned. The string is then terminated with a 
null byte after the last character of the "picked" string. 



10 DIM A(10),B(10) 

20 $A(0)s"ABCDEFGHIJKLMNOPQRSTUVWXIZ« 

30 $B(0)s|A(0;4),6 

40 $B(0|5)s$A(0),1 

50 PRIKT $3(0) 

60 STOP 

HON 

DEFGA 

STOP AT 60 

6.5 CHABACTEH REPLACEMENT 

Character replacement is very similiar to character pick with the 
exception that a null is not placed at the end of the string. 

Form: 

$<?AR>s <$VAR>;<EXP> 

Example: 

10 DIM A(10),B(10) 

20 $A(Q)s"ABCDEFGHIJKLMNOPQESTUVWrCZ" 

30 $B(0)=$A(0;M),6 J PICK" 6 CHARACTERS 

40 $B(0|5)s$A(0);1 ! REPLACE 1 CHARACTER 

50 PRINT $B(0) 

60 STOP 

RUN 

DEFGAI •: : 

STOP AT 60 
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6,6 CHARACTER INSERTION 

Characters can be inserted into a string variable by using the 
slash (/) operator. 

Form: 

$ <VAR> =/ <$VAR> 

The string is inserted without a null. 
Example: 

.10.- DIM Ado) 
20 $A(0)s»ABCDEFG" 
30 $A(0|4W..." 

40 PRINT $A(0) ' 

50 STOP 

RUN 

ABC. ..DEFG 

STOP AT 50 

6.7 CHARACTER DELETION 

Characters are deleted fi'om a string variable by using the same divide 
operator fallowed by an expression. 

Form: 

$<7AR> s / <EXP> 

The evaluated expression indicates the number of characters to be 
deleted. 

Example: 

10 DIM Ado) 

20 *A(0)s«ABCDEFGHIJKLMNOPQRSTUVWXYZ'' 

30 $A(0;5)= /lO 

40 PRINT $A(0) 

50 STOP 

RUN • 
ABCDOPQRSTUVWCYZ 

STOP AT 50 
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6.8 BYTE REPLACEMENT 

Individual bytes aay be altered b"r~«sing the numeric equivalent of an 
ASCII character along with the "$" operator^ 

Fensj ^ 

$<7AiC> = $<EXP> ... 

Byte replacements may be chained together. The byte value may be 
specified as either a hexadecimal or decimal value. The evaluated 
esepression specifies the byte code to be placed in the string 
vsff^iable. A null terminating byte is not placed at the end of the 
string. In some applications, the user, should manually place the 
100^, terminating null byte on the end of string, as in the following 

example . 



10 DIM A(10) 

20 $A(0)s$i{1$42$00 

30 PRUJT $A(0) 

40 STOP 

RUN 
AB 

STOP AT 40 . 

6.9 CONVERT ASCII CHARACTER TO NUMBER 

A character string may be converted to a number by using the 
f^ assignment operator along with an error variable. 

Forms 

<?AB> s <$VA10 , <7AR> 

The delimiting character is placed in the first byte of the error 
variable. Hence, the eonva:»sion routine was successful in converting 
the whole string if a null was the resulting delimiter. 

Example : 

10 $NUMs«12DE'' 

20 Ns"1234'»,E 

30 M1s^NUM,E1 

40 PRINT N,$E 

50 PRINT N1-,$E1 

60 STOP 
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RUN i 

1234 

12 D 

;. • STOP AT 50 ; 

Note that the first numeric character j string was successfully 
converted with no invalid characters encountered • However, the second 
numeric character string converted only tjie string "12", and placed 
the non-numeric "D" character into the variakble El. 

6.10 CONTEST NUMBEH TO ASCII CHARACTER : 

A aunber can be converted to a string sijuply by assigning the niimber 
to a str'ing variable. 

$ <var> s <exp> 

The string will properly be tenoiaated with a null . 

Example: 

10 DIM A(10),B(10) 

20 $A(0)s4»ATN(1) 

30 $B(0)s SQR(2) 

40 PRINT $A(0), $B(0). 

50 STOP 

RUN 
3.141592 1.414213 

STOP AT 50 

Formatted conversions can also be made by preceding the expression 
with the formatting operator "#" and a string. The form is: 

$<VAR> s # <$VAR> , <EXP> 

The formatting rules are the same as those given under print • 
formatting. (See paragraph 5.8.2.1.) 

Example: 

10 DIM A(10),B(10) 

20 $A(0)s#''999,99O.99",1234 

30 •$B(0)s#"<«,«<.00>",-1234 

40 PRINT •$A(0),$B(0) 

50 STOP ' 1 

i 

RUN i 

1,234.00 <T,234.00> 

STOP AT 50 
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6.1.1 STRING LENGTH FUNCTIO'N 

The length of a- string variable is returned by using the LEN function. 
Form; 

LEN«$VAIC>) 
A zero is returned if the string is the null string. 



- '10 DIM A(10),B(10) 
20 $1(0)="" 

^ 30 ^BCOsWABCDEFGUIJKLMNOPQRSTDMVWrZ" 

MO PRINT LEN($A(0)),LEN($B(0)) 
30 STOP 

RON 
26 

STOP AT 50 

6.12 CHARACTER SEARCH. FUNCTION 

To search for a given string, use the SRH function. 
Form: • 

SRH «$VAS>,<$VAR» 

The function returns the character position indicating where the 
first string is located in the second string. If the search is 
unsuccessful, a zero is returned. 

Exasple: 

10 DIM A(1Q),B(10) 

20 $A(0)s«ABCDEFGHIJKLMNOPQRSTUVWXIZ'' 

30 $B(0)a"ZIXW7UTSRQPONMLKJIHGFEDCBA" 

MO S1sSRH("EFG'»,$A(0)) 

50 S2sSRH("EFG«,$B(0)) 

60 PRINT S1,S2 

70 STOP 

RON . 
5 

STOP AT 70 

20 $SET ( ) s « ABCDEFGHIJKLMNOPQRSTUVWXYZ« 
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STOP AT 70 



10 Dm SET(5) 

20 $SET(0)s''ABCDEFGHIJKLMNOPQRSTimiXIZ''3O PRINT 

30 PRINT 

40 POS=SRH($CHR,$SET(0)) 

50 POSsSRH($CHR,$SET(0)) 

60 IF POSsO THEN GOTO 30 
70 ELSE $CMs$SET (0;P0S)-,1 

. 80 PRINT "POSITION s »|POS, "CHARACTERS "j$CHA 

90 GOTO 30 

,100- 'STOP 

INPUT CHARACTER 2 
POSITI0N=26 CHARACTERsZ 
INPUT CHARACTER U 
INPUT CHARACTER 



6.13 CHARACTER MATCH FUNCTION 

When looking for character agreement, the MCH function can be used to 
return the nxiober of characters which are the sane for two strings. 
Fora: 

MCH (<$VAR>, <$VAR>) 

A zero is returned if a match is not found. 

Example : 

10 DIM Ado) 

20 $A(0)="ABCDEFGHIJKLMNOPQRSTUWXYZ« 

30 PRINT MCH("ABCDXrZ'',$A(0)),MCH(»BCGH",$A(0;2)) 

40 STOP 



RUN 
4 2 

STOP AT 40 

5.14 ASCH CHARACTER CONVERSION FUNCTION 

The ASC function returns the ASCII decimal numeric value of the first 
character of the specified string variable. 
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Fona: 

ASC($<?AE» 

The ASC function is the iaverse of the byte replacement operator (5), 
i.e., $A s $A5C($A). 

The following example takes the upper ease string in the variable 
lACO) and converts it to the lower ease string in the variable $B(0) 
using the ASC function to obtain the decimal ASCII code for the 
character conversions. 

Note that the 7DT913 video display terminal does not support lower 
ca'se characters, therefore this example will not function correctly 
^ when executed on the Host POWER BASIC using the VDT913as the terminal 
device. 

Example: 

10 DIM A(10),B(10) 

20 INPUT "INPUT STHING", $A(0) 

30 FOR Isl TO LEN ($A(0)) 

^0 $Cs$A(0;I),1 

50 IF $Cs" " THEN $B(0;I)s" " 

60 ELSE $B(0;I)s$(ASC($C)+020H)SO 

70 NEXT I 

80 PRINT $A(0) 

90 PRINT $B(0) 

100 STOP 

RUN 
a^ INPUT STRING: UPPER CASE TO LOWER CASE 

UPPER CASE TO LOWER CASE 
upper case to lower case 
INPUT STRING: 
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SECTION VII 
POWER BASIC FaNCTIONS 
7.1 GENERAL 

POWER BASIC includes several predefined mathematical, string, and 
miscellaneous functions. The Host POWER BASIC Interpreter supports 
all the functions presented below, while the Target or "Configured" 
POWER BASIC Interpreter supports all of the functions with the 
exception of FRA, SGN, and TAN. These functions may be used in an 
application on the Host POWER BASIC Interpreter; however, they may not 
be configured into a Target POWER BASIC Interpreter and application. 

A function is called by using the following form in any statement 

where a variable may be used: • ''^^ 

function name «arguffient>) 
where 

function name is a three-letter name 
argument may be an expression or variable. 

The specified function of the argument replaces the function name in 
the statement in which it is used. Functions may be used instead of, 
or in combination with, variables in almost all POWER BASIC 
statements such as: assignment, PRINT, IF, FOR, ON, DEF, etc. 

7.2 MAIHE21ATICAL FUNCTIONS 

Paragraphs (7.2-. 1 through 7.2.10) describe the mathematical functions 
and their associated forms provided by POWER BASIC. 



7.2.1 ABSOLUTE VALUE FUNCTION (ABS) 

The absolute value function (ABS) obtains the absolute value of a 
positive or negative number. The argument entered following the 
function name is the variable name or numeric value for which the 
absolute value is required. The function returns a non-negative 
argument unaltered and returns the "absolute value of a negative 
argument . 

Example : 

10 INPUT X 
• 20 PRINT SQR (ABS (X)) 
30 STOP 



/■^'^^ 
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7.2.2 AHCTMGMT FDNCTION (AIN) 

The argument entered f ©Hewing the function name is the ratio 
representing a tangent function. The function returns the corre- 
sponding angle in radians . Multiply the nuaber of radians by 
180/3.14159265 (Pi) to obtain the angle in degrees. 

Example: 

10 INPUT X 

20 D s ATN(X)*(l80/5. 14159265) 
30 PRINT D • 
,- ' 40 STOP 

Executing the above example produces s . 

? 5.9246 
80,419473 

7.2.3 ' SINE AND COSINE FUNCTIONS (SIN) (COS) 

The argument entered following the function name represen-ts an angle 
in radians. When the angle is measured in degrees, multiply the 
number of degrees by S". 14159265 (Pi) /180 to obtain the angle in 
radians. The function determines the quadrant corresponding to the 
argument and* returns the function value. 

Example : 

10 INPUT N 

20 PRINT- SIN (N ) I COS (N) I 

30 STOP 

Executing the above example produces? 

? 1.25 
0,94898462 0.31532236 

7.2-. 4 EXPONDfTIAL FUNCTION (EXP) 

The argument entered following the function name is an exponent of e 
(the base of natural logarithms). The function returns the value of e 
raised to the power specified in the argument. 

Example: 

10 INPUT E . • ;. - - 

20 PRINT EXP(E) ... 

30 STOP 



7»2 



Executing the above example produces: 

? 25 
720048S900 

\ 

7.2-. 5 FRACTIONAL PAET FUNCTION (PIA) 

T3ie ft'actional part function (FRA) returns the signed fractional 
portion of the argument. Effectively, FRA(X)sX-(INP(X)). 

Example; 

10 INPUT E 

20 PRINT FRA(E) "**> 

30 STOP 

Executing the above example produces; 

? 3.1415926 
.14159260 

Target POWER BASIC Interpreter: The FRA function- is not supported by 
the POWER BASIC Configurator. Therefore, the FRA function should not 
be present in a -final application which is to be configured into a 
customized (Target) POWER BASIC Interpreter. 

7.2.6 INTEGER PART FUNCTION (INP) • , 

The integer part function (INP) returns the signed integer portion of 
the argument. The INP function is useful in modular arithmetic and 
for correcting errors resulting from truncation or rounding of ^ 

functions. The argument entered following the function name is the 
value for which the integer portion is required. 

10 As3 2 

20 PRINT "A = "jA, •'INP(A)= «;INP(A), 

30 PRINT ''INP(A+1E-07)4 '•;INP(A+1E-07) 

40 STOP 

Executing the previous example procedues: 

A s 9 INP(A) s 8 INP(A+1E-07) s 9'- 
STOP AT 40. 
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7.2,7 L0GAHI1SM FUNCTION (LOG) 

. The argument entered following the function name is the value for 
which the natural logarithm (base e) is required. The function 
returns the natural logarithm of the argument. Attempts to find the 
lei^ithffl of a non-positive argument will resiilt in an error. (LOG OF 
NON-POSITTTE MJMBEH). 



10 INPUT L 

20 PRINT LOG(L) 

30 STOP 

^^g^ Executing the above example produces: 

? 5280 
8.5716814 

7.2.8 SIGN FUNCTION (SGN) 

The sign function (SGN) tests the sign of a value. The argument 
entered following the function name is the value to be tested. The 
function returns +1 when the argument is a positive number, or -1 when 
the argument is a negative number . The function returns zero when the 
a'rgtaflent is zero. 

Example: 

10 INPUT A 

20 IF SGN (A) THEN GOTO 50 

^ 30 PRINT LOG(A) 

^ 40 GOTO 10 

50 PRINT "LOG VALUE UNAVAILABLE" 

60 STOP 

Executing the above examples produces: 

? 10 
2,3025851 
?-20 

LOG VALUE UNAVAILABLE 
STOP AT 60 

Target POWER BASIC Interpreter-. The SGN function is not supported by 
-■.:. ::•... the-. POWER BASIC Configurator. Therefore the SGN function' should not-. 

^« present in a final application program which is to be configured 

into a customized (Target) POWER BASIC Interpreter. 
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7.2.9 SQUARE ROOT FUNCTION (SQR) 

The square root function (SQR) returns the square root value of the 
specified argument. The arguoent entered following the function name 
may be positive or zero. The function returns the square root of the 
argxuaent. An error message (SQUARE ROOT OF NEGATIVE NUMBER) is 
produced if the argument is negative. 

Example: 

10 INPUT K 
20 PRINT SQR(K) 
30 STOP 
Executing the above example produces? 

? 2 y»-^ 

r. 41421 36 

7.2.10 TANGENT FUNCTION (TAN) 

The argument entered foUowing the tangent function (TAN)- represents 
an angle in radians. When the ai^gle is measured in degrees, multiply 
the number of degrees by 3. 14 159265 (Pi) /180 to obtain the angle in 
radians. The function determines the quadrant corresponding to the 
argument and returns the tangent. 

Example t 

10 INPUT M 

20 PRINT TAN(M) 

30 STOP 

Executing the above example produces; -^ 

? 0.137 
0,13786360 

Target POWER BASIC Interpreter: The TAN function is not supported by 
the POWER BASIC Conf igurater . Therefore the TAN function should not 
be present in a final application which is to be configured into a 
customized (Target) POWER BASIC Interpreter. 

7.3 SIRING FUNCTIONS -r 

The string functions described in Paragraphs 7.3.1 through 7.3.4 may 
be employed in POWER BASIC programming. 
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7.3.1 ASCII CHARACTEH CONVERSION FUNCTION 

The ASCII character conversion function (ASC) returns the deeinal 
> ASCII numeric value of the first character of the specified string. 

For additional details, refer to Section 6, Paragraph 6.14. 

E^eample: 






10 
20 
30 
40 
50 
60 


$AsWB" 

BsASCM 

$Cs$B+020H 

D=ASCC$C] 

PRINT $A,B,$C,D 

STOP 


RUN 
B 


« 


STOP 


AT 60 



66 • b 98 



7.3.2 STRING LENGTH FUNCTION (LEN) 

The string length function (LEN) returns the nuaber of non-null 
characters starting at the evaluated variable address. The argument 
of the LEN function must be specified as a string by either the $ er 
"string constant" operators. For additional details, refer to Section 
6, paragraph 6.11. 

Example: 

10 $Is"ASC" 
f"^^ 20 JsLEN($I) 

30 KsLENCABCDEFGHIJKLMNOP") 
40 PRINT J,K 
50 STOP 

Executing the above example produces; 
3 16 

7.3.3 CHARACTER MATCH FUNCTION (MCH) 

The character match function (MCH) returns the number of characters to 
which the two strings agree. A value of zero indicates no match. For 
additional details, refer to Section 6, paragraph 6.13, 
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Example: 

10 $Cs"ABCD" 

20 MsMCH("AB",$C) 

30 PRINT M 

40 STOP 

Executing the above example produces: 

2 (RESULT) 

7. 3-. 4 CHARACTER SEiHCH FUNCTION (SRH) 

The character search function (SRH) returns the character position of ''^ 
string 1 in string 2. A character position of zero indicates an 
unsuccessful search. For additional details, refer to Section 6-, 
Paragraph 6.12. 

Example : 

10 $C s "ABCD" 

20 Ss SRH ("BC",$C) 

30 PRINT S 

40 STOP 

Executing the above example provides: 
2 (RESULT) 

.7.4 MISCELLANEOUS FUNCTIONS 

The miscellaneous functions described in paragraphs 7.4.1 through 
7.4.8 are supported by POWER BASIC. 

7.4.1 CRU SINGLE BIT FUNCTION (CRB) 

A CRU bit, addressed relative to a base displacement, is either read 
or stored according to program context. The displacement ranges from 
-128 to +127. (Refer to Section 5; paragraph 5.10 for details on the 
BASE statement.) The function returns a 1 if the CRU bit is set, and 
a if not set. Likewise, the selected "CRU bit is set to 1 if the 
assigned value is non-zero and to if the assigned value is zero. For 
ex^aple: 
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CRB(10)sO 

. will clear the tenth bit relative to the base, while 

CRB(11)s1 or CHB( 11)2345 

will 'set the eleventh bit on. Also, 

IF CHB(5) THEN Js4 

will set JsU if the fifth bit is 1. 

7.4.2 CRU FIELD FUNCTION (CSF) 

The specified number of bits are transferred to or read from the CRU 
starting at the address set by the BASE statement. (Refer to Section 
5, paragraph 5.10 for details on the BASE statement.) The specified 
number of bits ranges from to 15. If zero, all 16 bits will be 
transferred. For examples 

CRF(O) = -1 

transfers 16 bits (hex '-TFF') to theCRU address specified by the 
BASE statement. V9hile, 

VALsCRF(8) 
reads 8 bits from the CRO base address and stores the result in VAL. 

7.4-.3 KET FUNCTION (NKI) 

f^ The key function (NKI) conditionally samples the keyboard in run time 

mode. When the argument is zero the decimal value of the last key 
struck is returned and the key register is reset. A value of zero is 
returned if none of the keys were struck. If the argument is 
non«2ero, the argument is compared with the last key struck. If they 
are the same, a value of 1 is returned and the key register is reset. 
Otherwise, a value of is returned. For example, 

r s NKI(O) 

returns the last key struck, or a if none of the keys were struck; 
while 

IF HKI(041H) THEN PRINT "A" 

....... :- . PPtnts "A" if the last key entered was "A". The argument value may be 

- ■ expressed as either a decimal or hexadecimal numeric constant ©r 
variable. 
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7.4.4 SYSTEM INTERROGATION iStS) FUNTION :: 

The system interrogation function iSXS) obtains system parameters 
generated during program execution. For example, 

A s SIS(O) 

returns the control character entered during either numeric or string 
variable assignment when using the question mark (?) operator of the 
INPUT statement. <Refer to the INPUT statement, Section 5, paragraph 

5«8e1o2o) 

. A-a'SISd) 

returns the ERROR code number when an error is encountered and is used ^^ 
with the ERROR statement of Section 5, paragraph 5.6.6. 

A s SYS (2) 

returns the statement number in which the error occurred and is used 
with the ERROR statement of Section 5, paragraph 5.6.6. 

7.4.5 DaTA TIME (TIC) FUNCTION 

The delta time (TIC) function samples a real time clock and returns 
the current TIC value minus the expression value. For example: 

T s TIC(O) 
obtains current time, and 

calculates elapsed time since the time stored in the variable T (i.e 
TIC (T) s TIC (0) - T. ' 

The TIC function is one of the system dependent POWER BASIC features 
which operates differently on the Sbst POWER BASIC Interpreter on the 
FS990 system than on the Target POWER BASIC Interpreter on the TM990 
board based system. This implies that an application program using 
the TIC function will operate differently when executed on the FS990 
system than in the "Configured" POWER BASIC Interpreter and applica- 
tion which is to reside on the TMg90 board system. The user must be 
aware of the differences when developing a program on the Host POWER 
BASIC Interpreter and appropriately compensate for them before 
executing the Configuration process. That is, the user must modify the 
"?!u®L^^® ^^ function in the appUeation program to work correctly 
with the Target POWER BASIC Interpreter before performing the 
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Configuration process. The differences between the systems are 
presented below. 

Host POWER BASIC Interpreter: 

The TIC function of the Host POWER BASIC Interpreter utilizes the Date 
and Time Supervisor Call of the TX990 Operating System to obtain the 
current time of day and then calculates the current time value minus 
the expression value. The time value returned by the Supervisor Call 
has a maximum resolution of one second . Also note that the FS990 
system clock is always running Cie., it does not require the "TIME O" 
statement to start the clock). 

Th6 following example program will output a bell (ASCII code "07") on 
the terminal device once every five-seconds.' 

LIST 

10 REM THE CLOCK DOES NOT NEED TO 

11 REM BE STARTED OSING THE HOST POWER BASIC INTERPRETER 
20 $Bs?07$00 ! ASCII CODE FOR BELL 

30 AsTIC(O) 

40 IF TICCA) <5 THSJ GOTO 40 

'50 PRINT $B; 

60 GOTO 30 ' 

Target POWER BASIC Interpreter: 

The TIC function used in- the customized (Target) POWER BASIC 
Interpreter utilizes the real time clock of the TMS9901 Programmable 
Systems Interface on the TM990/100M or TM990/101M microcomputer board. 
The TMS9901 is progranmed to generate an interrupt (or TIC) every 40 
milliseconds (1/25th of a second) with a system clock rate of 3 MHz. 
This results in a maximtaa resolution of 40 milliseconds in the final 
application. Note that TMS9901 clock must be started by the user 
through execution of the "TIME 0" statement or by setting the clock 
via the "TIME <exp> , <exp> , <exp>" statement for the TIC function to 
return meaningful values. 

The following example program when "Configured" in a POWER BASIC 
application will output a bell (ASCII code -"07") on the terminal 
device once every five seconds. 

LIST 

10 TIME « THIS WILL START THE CLOCK 

20 $Bs$07$00 ! ASCII CODE FOR BELL 

30 AsTIC(O) 

• 40 IF nC(A) <5»25 THEN GOTO 40 

50 PRINT $B| '.-... 

60 GOTO 30 • — ■ 
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lA.e I-IEMORY INTERROGATE/MODIFY (MEM) FUNCTION 

The memory interrogate/modify (MEM) function reads or modifies a 
memory location (byte) as specified by the argument. This argximent 
may be expressed as either a decimal or hexadecimal numeric constant 
or variable. For example: 

M s MEM(OFFOOH) 
reads the byte from location hex "FFOO", while 

MEM(OFFOOH) s 15 

store?- a decimal 15 (hex "F") at location hex "FFOO"". 

The following example POWER BASIC program will dump a specified area 
of memory in 16-byte fields, with the ASCII byte equivalents displayed 
to the right. 



LIST 



MEMORY DUMP PROGRAM" 



00 PRINT g"C«;:: PRINT :: PRINT " 

10 PRINT 

20 INPUT "MEMORY START ADDRESS s "jST 

30 INPUT " MEMORY END ADDRESS s ";END 

40 PRINT 

50 PRINT "DUMP OF MEMORY FROM ";!?,ST;" TO »;#,END 

60 PRINT 

65 ST=2«INP(ST/2) 

70 FOR IsST TO END STEP 16 

80 PRINT #,I?" s "; 

90 FOR Jsl TO 1+14 STEP 2 
200 PRINT #jMEM(J);#;MEM(J+1);" "; 

210 NEXT J 

220 FOR Jsl TO 1+14 STEP 2 
225 PRINT " "; 

230 IF MEM(J)<020H LOR MEM(J)>07EH THEN $CHR=".":: GOTO 250 
240 $CHR=$MiM(J) 
250 PRINT $CHR; 

260 IF MEM(J+1)<020H LOR MEM(J+1)>07EH THEN $CHR=».":: GOTO 280 
2T0 $CHRsjMEM(J+1) 
280 PRINT $CHR; 

290 NEXT J 

300 PRINT 

310 NEXT I 

320 PRINT :: PRINT 

330 STOP 
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RUN 



MEMORZ DUMP PHOGRAM 



MEMORY StART ADDRESS s 02000H 
MEMORY iEND ADDRESS s 02060H 

DUMP OF ^ORI FROM 2000 TO 2O60 



2000 s 0202 44DC 06A0 2032 C020 44BC C080 0222 


,, D. 


.. 2 . 


. D. .. ." 


2010 s 002A 06A0 2032 CO 10 16F9 9828 0009 4518 


.* 


2 .. . 


.. .( .. E. 


2020 s U04 COOA 06A0 4958 C280 10CB 0200 7000 


• . . 


.. IX , 


P. 


2030 s 108B 0201 0900 2FC1 C0C2 05C3 C103 C0D4 




.. /. . 


> 9 9 • • - 9 9 


2040 s 1309 80C8 16FB C513 16F9 0484 C0E2 0002 




e e e e < 


3 9 9 9 9 9 » 9 


2050 s 16F5 04D2 045B 069F 1005 10AB CG50 C800 




.( ., . 


P .. 


2060 s 48EC 10AF 0200 48FC 10F9 4E4F 5420 5255 


H. .. 


.. H. . 


.. NO T RU 


STOP AT 330 









7.4.7 BIT MODIFICATION (BIT) FUNCTION 

The bit modification (BIT) function reads or modifies any bit within 
a variable 9 The function re-turns a 1 if the bit is set and a if not 
sets Likewise, the selected bit is set to 1 if the assigned value is 
non«2ero, and to zero if the assigned value is zero. For example: 

IF BIT (A, 1) THEN PRINT »^0N" 
prints "ON" if bit 1 of variable A is on; while 

BIT (A,2)s1 or BIT (A,2)s750 
turns «on" the second bit of variable A. 

Refer to Section 3, paragraph 3.7.7 for an application of the BIT 
function* 

7.4.8 RANDOM NUMBER (RND) FUNCTION 

The random number function (RND) is used to generate a psuedo random 
number between and 1. For examples 
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PRINT RND 

would return a random number like 

.2113190 

Refer to the RAHDOM statement paragraph 5.12 for additional 
information. 



■^ 



./^=^ 
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SECTION Tin 
POWEH BASIC CONFIGURATION PROCESS 



8.1 dlRODDCTIDN 



The user will 'utilize the enhanced statements, commaads, and functions 
of the Host POWER BASIC Interpreter when developing application 
programs which are designed for- execution in a final or- "Target" 
1M990 board environment. Once the user is .reasonably confident that 
the program developed on the Host POWER BASIC Interpreter will' perform 
the intended TM990 application, the user will SA7E the program in a 
diskette- file, and then perform the Configuration process. This 
process will produce an "application program customized" POWER BASIC 
run-time module. The configuration process consists of first •^ 
executing the POWER BASIC Configurator, followed by execution of the 
TX990 Link Editor; This process results in a faster and much smaller 
implementation of the POWER BASIC Interpreter linked with the original 
application program. The resultant run-time aodule is appropriately 
ROM/RAM partitioned for execution in a TM990/10.0M or TM99O/T01M 
microcomputer board system, and is appropriately termed the Target 
POWER BASIC application. 

8.2. irPICAL CONFIGURATION CICLE 

The POWER BASIC user should develop application programs using the 
techniques, statements, commands, and functions as described in 
Sections 3 through 7 of this manual. When final development and 
testing are as complete as possible without actual interface to the 
final target application, the user will perform the configuration 
process as outlined below. The Configurator reads the specified POWER 
BASIC application program, produces the Link Control file, root 
module, and Usting outputs. The TX990 Link Editor then uses this Link ^ 
Control File and root nodule to produce the final linked object module 
(Target POWER BASIC application). The Linked Object module will then 
typically be tested in the actual target application through use of 
the AMPL system. If the program functions correctly, this object 
module will then be programmed into EPROM's and mounted in the target 
TM990 system. The overall configuration cycle is shown in Figure 8.1 
on the following page. 

8.3 • POWER BASIC CONFIGURATOR 

T2ie POWER BASIC Configurator enables "the user to generate an 
• application customized POWER BASIC run-time module. This run-time 
module contains both the customized POWER BASIC Interpreter and the 
user's BASIC application program and is appropriately ROM/RAM 
partitioned for- execution in a TM990 system. The Interpreter is 
customized at the BASIC Statement and Function level with the 
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specified POWER BASIC application prograa, and results in a miniaum 
TM990 system memory (ROM) requirement for the specified 
application. The Goaf igura tor -sc^is the POWSR BASIC application, and 
"remembers", via the Link _ Control File, each of the POWER BASIC 
statements and functions used in the program. It then produces: 
1) the corresponding Link Control File, 2) the ROOT module 
containing the pseudocode representation of the POWER BASIC 
application program, and 3) a listing for a hard copy of the 
configurator- execution. The Link Control File will "INCLUDE" only 
those modules required to execute the application program. The Target 
(Configured) POWER BASIC Interpreter- does not contain the "editor" 
(which performs statement entry or modification), the "lister"' (which 
performs listing of a BASIC program), any of the POWER. BASIC commands, 
or°any unused statements of the POWER BASIC lan^age. 

8. J.I POWER BASIC APPLICATION PROGRAM '*^ 

The user- will develop application programs on the Host POWER BASIC 
Interprets* with the final goal of "configuration" into a customized 
application using the POWER BASIC Configurator. Several of the POWER 
BASIC statements and functions of the Host POWER BASIC Interpreter- are 
not supported by the Configurator and therefore cannot be included in 
a final application program intended for -configuration. In addition, 
several statements and functions operate differently on the Host POWER 
■ BASIC Interpreter than in a Targe tPOWER BASIC 
Interpreter/App-lication. These will be explained in the paragraphs 
below. 

8.3. V.I NON-CONFIGDRABLE STATEMENTS AND FUNCTIONS 

The Interpreter- of the Target POWER BASIC application does not contain 
the editor- function of POWER BASIC, therefore a POWER BASIC program 
may not be entered into a "configured" interpreter. This greatly ,^ 
reduces- the amount of overtiead reqxiired in the final application, and 
enables a much smaller interpreter/application module to be developed 
for- execution in TM990 applications where the program will not be 
modified and an editor is not required. Since an editor is not 
present, two of the statements of the POWER BASIC language are no 
longer required, and these are not supported by the Configurator and 
may not be configured into a Target application. The following 
statements fall into this category: 

ESCAPE 
NQESC 

Similarly, none of the POWER BASIC commands may be configured into a 
target application, since commands cannot be entered into a program 
and they are only used during program development. Therefore the 
following commands of the Host POWER BASIC Interpreter cannot be 
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iaeladed in aay target applications: 



conhndi 


ROU 


LIST 


SATE 


LOAD 


SOtJBCE 


HEH 


STACK 


WtSSER 


SIZE 


PUEGE 





Also, Bene of the file msaagement stateaeats of tie Host POWER BASIC 
Iateipi>eter aay be entered into sa. application program since there is 
no file support in the final target application. The following 
sl^teaeats fall into this category: 

BBS'S RESET 

BDEFR RESTOR # <ysr> 



BINARI 1 
BOPH? BINARI 2 

BCLOSE BINARI 3 

COPY BINARI il 

In addition, the fallowing statements and functions of the Host POWER 
BASIC Interpreter cannot be configured into a target application. 
These are not supported by the Configurator so that the resultant 
•JROOT module" can remain transportable to Development POWER B^SIC 
(part no. TM990/U51). That is, the user can take the pseudo code 
representation of the application program contained in the "9,qoT 
module", program it into EPROM, and place it in the Development POWER 
BASIC system. It may then be accessed and executed via* the "LOAD 
address" command of Development BASIC. For- additional info matron 
^.i^.^"^ paragraph &.il.J.l below or to the POWER BASIC REFERENCE 
MANUAL, MP308. To maintain this cempatiblity, ■ the following 
f^ statements and functions cannot be configured into a Target POWER 

BASIC application. 

BIE FRA 

DIGITS SON 

EQUATE TAN 

SPOOL <eursor positioning> 

If any of the statements or functions presented in this section are 
encountered during- Configurator execution, an error- code will be 
generated and the offending statement will be displayed. This 
statement will not be configured into .^he application, and the 
Configurator will continue with the next statement of the application 
• progiam. 



8,3-.1-.2 SPECIAL iSTATEMSNTS AND FUNCTIONS 

Some of the system dependent POWER 3ASIC statements and functions 
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operate differently on the Host P0W2R BASIC Interpreter on the FS990 
than on the Target POWER BASIC Interpreter in a TM990 board based 
system. An application program using these statements or- functions 
will function in a similar manner. However, it will operate in a 
slightly different manner-when executed on the Host Interpreter- than 
when on the "Configured" POWEB BASIC Interpreter- and application 
(which is to reside on the TM9 90 board system ). The user-must be 
aware of the differences when developing a program on the Host POWEE 
BASIC Interpreter- and appropriately compensate for- their use before 
executing the Configuration process. That is, the user must modify 
the use of these statements and functions in the application program 
to work correctly with the Target POWES BASIC application before 
perfojoiag the Configuration process. 

The statements and functions which fall into this category are 
presented below. The user- should reference the corresponding sections '*^ 
of this manual for the differences in -their operation between systems. 

BAUD TIC 

CALL TIME 

ttiASK TRAP 

IHTN UNIT 

HEM <tail reaarics> 

Also note that the user MUST include the BAUD statement in the 
application program if any terainal input/output is rea.uired, and must 
also use the UNIT Statement to appropriately direct the* output of the 
application to either- or both ports A and B of the TM990/101M board. 

8.4 CONFICUHATOR EXECUTION 

The user will call the POWER BASIC Configurator- into execution by 
perforaing the steps as outlined in Section 2, "LOADING AND EXECUTION 
OF HOST POWER BASIC INTERPRETER AND CONFIGURATOR". When the '^ 

Configurator is first called into execution, the following banner 
message and user input prompt are displayed on the terminal device. 

POWER BASIC CONFIGURATOR REV C.n.m 

APPLICATION SRCEs 

where, 

n s the release ntssber 
m. s revision number 

A. description of the prompts and associated user responses and 
entries is provided in the following paragraphs. 
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S.'H.I HSSPONDING TO CONFIGURATOR PROMPTS 

Tfee user's response to the APPLICATION SRCEs, OBJECT FILEs, LINK 
CONTROLS, and LIST FILEs will specify the application program to be 
eenfigiared as well as the devices/files to which the subsequent 
outputs will be directed. When responding to the Configurator 
prompts, the user must use the TX990 pathname syntax to identify both 
devices and files. The TX990 pathname syntax is repeated below for 
user convenience. 

8.4, 1>1 PATHNAME SICNTAX 

All TX990 pathnames adhere to the following rules: 

o All device pathnames consist of a one to four* character 
device name assigned to that device during system generation. 
Typital device pathnames are DSC, DSC2, LP, CS1, and CS2. The 
user must reference his system generation for the device names 
used in his particular TX990 Operating System. 

All diskette file pathnames consist of one to seven characters 
separated from the device name by a colon (-:). • The first 
character must be alphabetic (A-Z); the rest may be 
alphanumeric. The file 'name is followed by an extension to 
the file name, which is one to three characters separated from 
the file name by a slashC/). The first character must be 
alphabetic, the rest -must be alphanumeric. The file name and 
■ extensions are specified when the file is created. Typical 
valid diskette file" names are: DSC2:L0Ar)/0KE, DSC: PROGRAM/FIN, 
and :PR0CSSS/CNT. Invalid diskette file names would be 
DSC: TEMPERATURE/ OBJ — too many characters, DSC2: FILE/9 15 — 
first character- of extension must be alphabetic, and 
•DSC:MOTOR/STEP — extension too long. 

The Configurator /TX990 interface checks the syntax of all file and 
device names as they are entered by the user. If the pathname syntax 
is illegal, an invalid pathname error code will result, and the prompt 
will -be issued again. Similarly, if the specified device/file does 
net exist when attempted to be opened, an undefined file name error 
win result and the prompt will be issued again. 

If a diskette file is specified to receive one of the outputs of the 
Configurator-, it must have been previously defined by either the 
BDEFS POWER BASIC statement or- by the create file (CF) coaasand of the 
SISUTL package. 

For example: ■.-..-.: 

BDEFS ''DSC2: PROCESS/OBJ" 
BDEFS "PROCESS/LNK" 
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BDEFS "DSC2 : PR0C2SS/LST" 
. or, siailsff'ly, 

OP J CF,DSC2: PROCESS/OBJ 
OP; CF,DSC2:PH0CESS/LNK 
OP? CF,DSC2:PR0CESS/LST 

8.4.1-.2 APPLICATION SHCEs Prompt 

The user's response to the APPLICATION SRCEs preopt will specify the 

pathaaae of the POWER BASIC application program to be configured. The 

Configurator- will "immediately open and rewind the specified • 
device/K^e. 

The userMDST enter* a valid pathname of a device/file vrtiich contains a -^^ 
POWER BASIC application program before he may continue to the next 
prompt* 

Typically, the application source will reside on the application 
diskette in the right-hand diskette drive (DSC2). The. left-hand - 
diskette drive (DSC) is reserved for the master or- production diskette 
containing the Power Basic Configura-tor and Link Editor programs. 
Typical application source, responses would be: 

APPLICATION •SKCS=DSC2s PROCESS/SRC 
APPLICATION SRCE=DSC2-: FILE 1 /PRO 
APPLICATION SRCEsDSC2: MOTOR/SRC 

8.4. 1-. 3 OBJECT FILEs Prompt 

The user's response to the OBJECT FILEs prompt will specify the 
pathname of the device/file to receive the "ROOT module" produced by 
the Configurator". This ROOT module contains the pseudo-code '^ 

representation of the application program. The application program is 
translated into internal, pseudocode by the "editor" (or- translator) 
function of the Configurator. This pseudocode or ROOT module is then 
stored into the specified device/file for- use by the TX990 Link Editor 
when producing the final Target POWER BASIC Interpreter/Application. 

The user need not enter a response to the OBJECT FILEs prompt if this 
output is not required. Howeve*, in most cases the user will enter a 
valid pathname in response to the OBJECT FILEs prompt since this file' 
is required to generate a final Target POWER BASIC application. If a 
diskette file is specified, it must have been previously defined by 
• either the BDETS POWER BASIC statement or by the create file (CF) 
command of the SISUTL package. 

• 

Note that the left hand diskette drive is reserved for- the master or 
production diskette, and the right-hand drive is used as the 
application diskette. Therefore, the user- typically directs the 
OBJECT FILEs output (ROOT' module) to the right-hand diskette (DSC2) . 
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Typical Object File" responses would bet 

OBJECT FILEsDSC2: PROCESS/OBJ 
OBJECT FILEsDSC2:FILE1/0BJ 
OBJECT FILE=DSC2:M0T0R/0BJ 

8.4,t.4 LIHK CONIHOLs Proapt 

The user's response to the LINK CONTBOLs prompt will specify the 
pathname of the device/file to receive the link control sequence 
produced by the configuration process. This control file will later 
be specified in response to the INPUT; prompt when the TX990 Link 
Editor- is executed. The link control file will 'contain the 
•appropriate LIBRAEI, END, TASK, and INCLUDE commands to perform the 
final link of the Target POWER BASIC Interpreter/ Application. It will 
contain INCLUDE commands for all object modules required by the 
?«^?nJI°^^ ^°^ functions of the application pregS?, as well al 
INCLUDE commands for the START module (core module of the 
Sr-?^/^''®r<' ^^® ^°°^ module (ie., the user response to the OBJECT 
flL«s Prompt), and any assembly language modules referenced by a CALL 
statement in the application program. 

lllJ^^^^'.^^^J^} ®?^®r ^ response to the LINK CONTROLr prompt if this 
ouwput IS not desired. However; in most cases the user wiP enter a 
valid pathname for the LINK CONTROLsprompt since this output is 
required to generate the final Target POWER BASIC application. If a 
diskette file is specified, it must have been previously defined by 
either the BDEFS POWER BASIC statement, or by the create fUe (-CF) 
command of the SiSUTL package. 

Note that the left-hand diskette drive is reserved for- the master or 
production diskette, and the right-hand drive is used as the 
rn^pn?^^°\^^f^^* ^«^-^«^' ^^^^ «ser typically directs the LINK 
SSai"r.o?ir^ ^"^ the right-hand diskette (D^C2). Typical Link 
concoi responses would be: 

LINK C0NTR0L=DSC2:PR0CESS/LNK 
LINK C0NTR0LsDSC2:FILE1/LNK 
LINK C0NTR0LsDSC2:M0T0R/LNK 

8.4,1.5 LIST FILSs Prompt 

, The user's response to the LIST FILEr prompt will specify the pathname 

of the device/file to receive the listing output produced by the 

Configurator; The Configurator will immediately open and rewind the 

• specified device/file. This list file will contain a complete listing 

of the configuration prscess. It will contain any "edit" errors which 

■ .occurred, a list of statements and functions used by -the application 
program, and a list of object modules "INaUDED" by the Configurator. 

The user need not enter- a response to the LIST FILE prompt if th-^s 
output is not desired. However, the user will typically enter a vaUd 
pathname for this prompt to receive a listing of the configuration 
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process. If a diskette file is specified, it must have been 
previously defined by. either the BDEFS POWER BASIC statement or by the 
. create file command of the SISUTL package. 

Typically the user will direct the LIST FILE= output directly to the 
line printer (LP) or to a diskette file on the application disk 
(DSC2). If directed to a diskette file, the listing may later be 
output on a printer device through use of the TXCCAT or LIST 80/80 
utility program. 

8.4-.t.6 SPECIAL KEYBOARD CONTROL KEXS 

The special keyboard control keys for the 7DT911 and VDT913 terminals 
are disscribed in Table 8-1. Note that the phrase •"( Ctrl)" indicates 
that the user holds down the control key while depressing the key 
corresponding to the character immediately following. (Refer to 
Figure 8-1.) 






TABLE 8-1 
SPECIAL CHARACTERS 



■7DT911 



VDT913 



FUNCTIONS 



(Ctrl) D 
(Ctrl) 2 

unlabeled function 
key » 

RETURN 

I (down arrow) 
ENTER 

(Ctrl) J 

(Ctrl) M 

f (up arrow) 
(Ctrl) X 

ERASE, FIELD 

ERASE INPUT 

(c1rl) C 

DEL. CHAR 
••-(left- arrow) 
(Ctrl) H 



RESEj 



Terminate Configurator 
execution and return to 
TX990 Operating System 



NEW LINE Enter user response 
I (down arrow) 



](up arrow) Backup to previous prompt 



^^•i^trft. 



OEAR 
DEL LINE 
BACK TAB 

DEL CHAR 
•-(left arrow) 



Clear current user response 



Backspace and delete character 



» - Designates unlabed function key in upper right hand comer of 
keyboard. 
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8.if.1-.7 CONFIGUHATOR ERBORS 

The Configurator will display error codes to indicate any errors which 
occur- during, user prompt response or during Configurator execution. 
All errors are reported in two basic formats. 

J^ r^^i. fcrasat displays errors detected by the Configurator or by 
the Configurater/TX990 interface. Many of these errors win result 
SffiSi?^^^' device/file access is attempted iT^rls^se tf a 
^ n^.^ r.'"J'^^^^' ^^® remainder of these errors are detected by 
tlnsla\\on ^:^\''V^ '?" configurator during POWER BASIC slatlmeni 
!^^., oV"!;. . internal pseudocode. Kie Configurator -reports all 

JoZl ?olS^g'?oUt:''^ ^^^^ ^^ ^ ''''^^' ^'^'^ ^^'^ -^=^ ^^^ 

^fi*8y ERROR jQ^ 

where, 

n is the decimal code corresponding to the error which occurred 
For example: 

•ERROR 44 
*SRROR 07 

The error codes and corresponding error messages gene-^ted bv -h^ 
^rSl'/lf^'^:^^"- P-^^^^°^^^ ^= Appendix A»1 and^^-S.' ApS^ndiJiT-l 
'o^R 31510 In^Tr^rrr^' -d messages which apply to both the Host 
;~:Lf ,, Iflwerpreter-and the Configurator, while Appendix A-2 
presents all errors exclusively reported by the Configurator 

r- lHtlT''\lT^l^^^^^^^ ^^ ^^"^^ reported by the TX990 Operating 

■ SS, ?*- J? nl7®C^ ^""^ reported to the user as hexadecimal codes 
with a trailing "H" character using the following format;.. 

FILE I/O, ERROR OOXXH 



where, 



XX is the hexadecimal code corresponding to the TX990 error 
wiich occurred- 



Appendix A-3 presents the hexadecimal codes- and corresponding er«or 
messages reported by the TX990 Operating Sy^'tem. "^^^"^^-^S error 

8.4.2 • CONFIGURATOR OPERATIOH 

^nf^l^^L^^^^^''^^''^ ^ responseto the final LIST FILErproi^t; the ^ 
fS^s!"^^°'' ^^^'""^ execution. The Configurator first re?ds the 
!! ti r. t? ^"'!'^ ^"^ ^^^ specified APPLICATION SRCEr device/file. 
AS the Configurator reads' each POWER BASIC statement, the statement ?s 



8-10 



first translated into interaal pseudocode by the "editor" or 
translator function of the Configurator, and then stored into memory. 
This continues until the entire application program is stored in 
memory in pseudocode form, and the APPLICATION SHCEs device/file is 
then closed. 

For ex^sples 

FILE I/O EREOR 0027H 
FILE I/O ERROR 0Q22H 

If any invalid- or- unrecognizable statements or- functions are 
encountered during trsmslation, the corresponding error code and the 
offendiag statement are displayed on the terminal device and output to 
the LIST FILE. The entire statement line is omitted from the 
pseudocode and' translation continues with the next statement of the 
application. The error- codes generated by the "editor" are presented 
in Appendix A-1-. The user should carefully look over the detected 
errors and the original application program to make sure that these 
statements are not required for application execution and also that 
they are not referenced by other statements within the program. These 
type of errors are generally caused by including statements or- 
functions which are only supported by the Host POWER BASIC Interpreter 
and not by the Configui^tor or Target POWER BASIC Interpreter. 

The Configurator - then scans the pseudocode of the application program 
and determines which object modules need to be included from the 
object module library in the. final Target Interpreter/Application. As 
each statement and function is encountered in the application program, 
it is appropriately mariced in the "STATEMENTS USED" and "FUNCTIONS 
USED" tables for- later output tc the LIST FILE. Similarly, as each 
object module is referenced by the application program it is marked in 
the "MODULES USED" table, also for output to the LIST FILE. 

Next the. OBJECT Fn.E is opened, and the pseudocode of the application 
program (or- ROOT module) is written to the specified device/file, and 
the OBJECT FILE is then closed. 

The LINK CONTROL device/file is then opened, the link control sequence 
corresponding to the application program is written, and the specified 
device/file closed. 

T3ae Configurator- outputs the listing of the configuration process and 
closes the specified device/ file to complete the configuration of the 
current application program. 

The Configurator then prompts the user for the next program to be 
configured by output of the APPLICATION SRCEs prompt. The user may 
eater responses to the next sequence of prompts, or may terminate the 
Configurator by entering the ESCAPE key (RESET function key on 7DT913, 
or- unlabeled function key in upper right-hand corner of 7DT911). Also 
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note that the user may enter the ESCAPE key ia reponse to say of the 
prompts, or duriag the actual configuration process to terminate 
Configurator- execution. When the Configurator- is terminated, all 
files are closed, and control returns to the TX990 Operating System. 

8«^.3 COHFIGDRATOR OUTPUTS 

The following paragraphs will explain the OBJECT FILE, LINK CONTIOL 
and LIST FILE Configurator outputs!, ' ^okisol, 

8. 4% 3.1 OBJECT FILE OUTPUT 

T^e OBJECT FILE output <-ROOT module) of the configurator will contain 
the pseudocode representation of the application program, 
piis pseudocode file will generally be used in the generation of a- 

direcwly into EPROM and used as the application program in a 
Development BASIC (TM09Q/i!51) system. Each of these uses will be 
presented below. 

f'.t'^^r^^^ ^^ ^^ typically used in the generation of a Target POWER 
feTth. n\*5?J^^^/T^i'^^'^^^''°* ^^^ device/file specified in response 
to the OBJECT rlLt prompt will receive the pseudocode fona of the 
application program, and an INCLDDS command referencing this module 
will also be generated in the LINK CONTROL. Execution of the rxooQ 
™4^i«''fH''^^-°^ this Link Control file will then appropriately 
^nS* «<.e^.^5® pseudocode application program into the final Target 
POWER BASIC Interpreter /Application. -^^-seu 

The OBJECT FILE produced by the Configurator -has been designed so that 
this pseudocode form of the application program may be directly 

syswem (IMO90/4S1) and executed in the desired application. T^-is 
B^TC t'..! T"" ^^ ^t^^°^ ^^^ application program on the Host POWER 
?^^„?fffP^^®^ ®« ^^« FS990, and then transport the pseudocode 
IT ^f/^ ^^^^"^ ^^^^*^y ^° ™550 board system without perfor^ng 
^ne ea*.ire configuration process when a customized Target POWER BASIC 
^terpreter- is not required. The OBJECT FILE /n^duced by the 
fS?^hfSr^?L^^ completely relocatable, and may reside ia EPROM 
anywhere within the memory map of the POWER BASIC system Once the 
ul^?L^^^?K^^ programmed into EPROM (typically using the TXPROM 
utility), the user will select the address space in the TM990 system 
most convenient for its location. :.• -' ,*/*''«^ 

NOTE ^ 

The OBJECT FILE produced by the Configurator has the 

"HUN" option ENABLED,- so that if the EPROM»s are placed •• '■ ^ 

^^f^'^®;^^ location 300016, the application program' 

win immediately begin execution when the RESET switch 

of the microcomputer board is activated. If the EPROM's 

are placed at any location other than hex 3000 <> ft, aetiva- 

vion of the RESET switch will initialize Development BASIC 

to the keyboard mode awaiting user keyboard input. 
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If the auto-ruo option described above is disabled by placing the 
EPRQM's at a oeffiory a dress other than hex 300C, g , the "LOAD address" 
command of Development BASIC (where the address corresponds to the 
location in memory at which, the EPROM's were placed) will initialize 
BASIC to enable access to the prog ram in EPROM. The user may LIST and 
execute this program; however, attempts to edit the program will 
result in an error; For- additional infotnation on Development BASIC, 
and the ability to access application programs in EPROM, refer to the 
TM990 POWER BASIC REFERENCE MANUAL, MP308. 

8. 4% 3'. 2 LINK CONTROL FILE OUTPUT 

The LINK CONTROL file produced by the Configurator- will 'be used when 
perfourmiag the final link in the generation of a Target POWER BASIC 
Interpreter/ Application. It will contain this app nap riate LIBRARI, 
END, TASK, and INCLUDE commands required to perform the link. The 
following example shows a typical link control file which the 
Configurator would generate for- an application program. 
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Example! 

NOSIMT 
NOAUTO 

LI3RARI :CBASIC/LIB 
TASK C3ASIC 
INCLUDE :STARTC/OBJ. 
INCLUDE (BAUDC) 
INCLUDE (CV3DC) 
INCLUDE (CTOB) ' 
INCLUDE (CVGC) 
INCLUDE (PRINTC) 
INCLUDE (22ENDC) 
INCLUDE DSC2:PR0CES/0BJ 
INCLUDE DSC2:ASSEM/0BJ 
END 



No symbol tables . ia final object 

Inhibits automatic external reference resolution 

Defines sequential object library 

Defines phase of link edit structure 

Includes core module of Inters rater 



INCLUDES object modules from library 
referenced by application program 



INCLUDES pseudocode or "ROOT module" 
INCLUDES CALLed assembly language modules 
Defines end of link edit 
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All Configurator generated Link Control files will: 1) specify no 
symbol tables in the final object module, 2) define the library 
containing the object modules of the Target POWER BASIC Interpreter , 
3) define the link edit as a final task with a name of CBASIC, 4) 
include the required STARTC/OBJ nodule, all referenced object modules 
ft'om the library, and finally the pseudocode representation of the 
application program ( or ROOT module) and. any assembly lang-uage 
routines CALLed within the application. • 

The user should note the following: 

• The LIBRARI containing the object modules for the Jarget 

POWER BASIC Interpreter must reside on the same diskette drive 
as the Configurator (ie., it must reside on the default 
diskette, typically the left hand drive) 
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• Tht STAETC/OBJ file must also reside on the saae diskette 
drive as the Configurator (i.e., it must reside on the 
default diskette, typically the left-hand drive. 

• The pseudocode representation of the application prograo or 
"ROOT module'' should reside on the secondaiy or application 
diskette, typically the right-hand drive. 

• Any assembly language routines CALLed fi?om the application 
program anist reside on the secondary or application diskette 
termed DSC2, typically the ri.ght-hand drive. 

8.il%3.3 LIST FILE OUTPUT 

: ■ The LIST FILE will 'contain compliete infonnation on the execution of 
r^ the Configurator. The following paragraphs and examples will explain 

the contents of this file". 

A header- will appear- at the top of each page of the LIST FILE denoting 
the release and revision number as follows: 

POWER BASIC CONFIGURATOR REV Cn.m 
where, 

a s the release number 
m s the revision number 

The first page of the LIST FILE will contain the Configurator proapts 
and user responses followed by any "edit" errors which occurred during 
BASIC statement translation into internal pseudocode. Any errors will 
be reported by an error code followed by the offending statemen. The 
error codes generated by the "editor" are presented in Appendix ^-1. 
Imediately following the error report on the first page will be the 
"NUMBER OF BITES OF PSEUDO SOUHCSs >XnX" output. This hexadecijsal 
value represents the number of bytes of internal pseudocode required 
for- the application. This is the number of bytes the application 
program will occupy in the Target POWER BASIC Interpreter /Application. 
The following example shows the first page of a typical cutout where 
some edit errors occurred? 

POWER BASIC CONFIGURATOR REV C.l.il 

APPLICATION S0URCE=DSC2j PROCESS/SRC ':• 
OBJECT FILEsDSC2: PROCESS/OBJ 
.• LINK C0NTR0LsDSC2:PR0CESS/LNK 

( EDIT ERRORS, IF ANT, LISTED HERE ) ' " •-• 

•ERROR 07 
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70 EQUATE YV, Y(1) 
*ERROR 44 

360 ESCAPE 
•ERROR 07 

400 LET IsSGN(X) 



NDMBER OF BITES OF PSEUDO SOURCEs>01AC 



The next page of the LIST FILE will present the module suaaaary of the 
object modules required by the application program. Each of these 
object modules will be referenced as the operand of an INCLDDE command 
in the. Link Control File, and the corresponding module will be 
included from the object library during the link of the final Target 
POWEH^ BASIC application. The .module stamnary also presents the number 
of primary references and secondary references of each required object 
module. The number- of primary references is incremented each time a- 
module is referenced directly by encountering a statement or function 
(in the application pnDgram) which is contained ia that module. The 
number- of secondary references is incremented each time that module is 
referenced by another module within the Ubrary. The f ©lowing example 
shows a typical module summary output:. 
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POWER BASIC. CONFIGURATOR HEY C.I. 4 









MODULE 


SUMMARY 












■ MODULES 


USED 








PRIMARI 


SECONDARY 








PRIMARY 


SECONDARY 


NAME 


REF 


REF 






NAME 


REF 


REF 


BAUDC 


1 


4 






C7BDC 





1 


CVDB 





2 






C7GC 





3 


GOSUB 


2 









IF 


1 





IPCOM 





1 






JMP 





. 1 


LET 


2 









MOTE 


Q 


1 


PRINTC 


1 









TICF 


2 





TIMEC 


• • 3 
















^,,<^SfcSv 



The next page of the LIST FILE will 'present a summary of the verbs (or 
statements) used in the application program. The summary will 
indicate the number of times each statement was used within the 
program, and will also indicate the object module in which the 
statement is located and any required support modules. The following 
example shows a typical statement summary output: 
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POWER BASIC CONFIGURATOR RE7 C.V.M 

STATEMENTS USED 



NAME 


# OF REFS 


MODULES 


GOTO 


2 


GOSUB 


(LET) 


2 


LET 


PBINT 




PRUfTC 


TUS 




TIMEC 


BASE 




BASE 


BAUD 




BAUDC 


IF 




IF 


CRF" 


2 


CSUF 




ncF 


msc 


SINF 




CRUF 


BASE 



BASE 

The aext and fiaal page of the LIST FILE will present a summary of the 
functions used in the application program. The summaiy will indicate 
the number- of times each function was used within the program the 
object module in which the function is located as well as any required 
support modules. The following example shows a typical function 
summary output; 

POWER BASIC CONFIGURATOR REV C.1.4 

FUNCTIONS USED 



# OF REFS MODULES 

""""■"I ■ 

2 

1 

&.4.i} CONFIGURATOR TERMINATION 

When the LIST FILE is output, the Configure tor has completed execution 
on the current application program and will again issue the 
APPLICATION SRCEs prompt for the next program to be configured. If no 
additional programs are to be configured, the user will enter the 
ESCAPE key (RESET function key on the VDT913 or the unlabeled function 
key in upper right r hand corner of the VDT911) to terminate the 
execution of the Configurator. The next step in the configuration 
process is the execution of the TX990 Link Editor. 

8.5 ' T2990 LINK EDITOR 

nie Link Editor enables the user to link together all the modules 
which comprise the Target POWER BASIC Interpreter /Application and 
resolve the external references of these modules. To permit fast and 
efficient linking of these modules, the use of a sequential object 
library was adopted. This library contains the object nodules of the 
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minimizes the search time for a module within the library and requires 
only one pass of the library for module inclusion. The sequential 
library approach REQUIRES the use of the TXSLNK Link Editor, version 
2.3.1 or later (located on the Tl-shipped TXDSLE 2250446-1606 **. 
2.3.1) to provide the enhanced support of sequential libraries. 

The following paragraphs will present the library and object modules 
required, as well as the execution sequence for the TX990 Link Editor. 

8.5.1 REFERENCED OBJECT MODULES 

The Configurator generated Link Control File requires that some of the 
object files be present on specific diskette drives in the system. The 
Targe't Interpreter Object Library and the Interpreter core module 
START/OBJ) are REQUIRED to be on the same diskette with the Link 
Editor. Any assembly language routines CALLed by the application 
program MUST reside on the secondary or Application diskette with the 
device name of DSC2. Also the Root module is recommended to be 
directed to the secondary or application diskette during Configurator 
execution. 

8.5.2 LINK EDITOR EXECUTION 

The user will load and execute the Link Editor via the TXDS Control 
Program. The user will call the TXDS Control Program into execution 
by performing the steps as outlined in Section 2, "LOADING AND 
EXECUTION OF HQST POWER BASIC INTERPRETER AND CONFIGURATOR". The TXDS 
Control Program assists in program loading and execution by displaying 
the following prompts om the system console: 

TXDS 936215 »A 291/78 10:30 

PROGRAM: 

INPUT: 

OUTPUT: 

OPTIONS: 

The user will respond to these prompts by entering the Link Editor 
program pathname in response to the PROGRAM prompt, the Link Control 

J File pathname in response to the INPUT prompt, the linked object file 
pathname in response to the OUTPUT prompt, and the options required to 

, the OPTIONS prompt. 

The Link Editor must reside on the primary diskette, tjrpically the 
left hand drive with a device name of DSC in the standard Tl-shipped 
operating system. Therefore, the following response is entered: 

PROGRAM: DSC: TXSLNK/ SYS 
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Onee this | entry is eeaplete, the INPUT preapt is displayed. In 
response to this prompt, the user enters the pathnaae ef the' file or 
deviee from whieh ;th€ control file is to be read. The Link Control 
Tile is generated by the Configurator, and generally resides on the 
seeondai7 or- applied tion diskette. The deviee/file' which received the 
Link Control File jwas specified by the user response to the LINK 
. CONTlOLs prompt. jThis pathnMje should be entered in response to the 
INPUT prompt. Eseamples are; 

INPUT: DSC2sFiN/LNK 
INPUT: DSC2:VAL7S/LNK 

Nest the OUTPUT prompt is presented, which requests that the following 
^^ies be made: 

^ OUTPUT: <object>,^-OLoad mag , {scratch]] 

These parameters have the following meanings: 

object - specifies the linked object output pathname 

load map - specifies the output listing pathname. If no 

entry is nade, the system default printer is used. 

scratch - specifies the diskette unit upon whieh the scrateh 

. files will be created. If no value is entered, the 
scratch files are created on the same diskette unit 
f^om which the Link Editor was loaded. 

Typically the user will direct the object output to the secondary or 
application diskette, will direct the load map to the Line printer and 
win take the default value for the scratch file parameter. For 

OUTPUT: DSC2:M0T0R/L0B, LP 
OUTPUT: DSC2:7ALVE/L0B, LP ' 

Next the OPTIONS prompt will be displayed. In response to this 
prompt, the user can either- enter the number of bytes (in decimal) of 
memory available to the Link Editor- for the table area, or make no 
entiy and accept the default of 8192 bytes. It is recommended that 
the user enter the largest memory size value which the operating 
system will accept to insure that enough memory is allocated to 
successfully link the program. The user will need to perfonn a trial 
and error approach to determine this vaiue for the particular 
operating system configuration being used. .4ay entry made by the user 
to the OPTIONS prompt is proceeded by the letter M. For example: 

OPTIONS: Ml 5000 i " • 

OPTIONS: Ml 2000 t 
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The following examples show typical responses to the T3QS Control 
Program prompts: 

TTDS 936215 *A 291/78 11:00 

PROGHAM :DSC ; T2SL2K/SIS 
INPUT: DSC2: PHOCESS/LSK 
00TPtrT:DSC2: PROCESS/LOB, LP 
OPTIONS :M1 5000 

. cr similarly, 

Xps. 936215 »A 291/78 11:00 

PROGHAM :DSC : TXSLNK/STS 
INPUT:DSC2:MQT0R/LNK 
0DTPUT:DSC2:M0T0R/L0B, LP 
OPTIONS :M1 5000 

The Link Editor will then begin execution. It will, read the control 
file, include the specified object files, and perform the • search of 
the library for the specified modules to be included. This process 
will continue until all of the INCLUDES have been processed, with 
final undefined exte.mal reference resolution being performed before 
Link Editor termination. For additional information "on the execution 
of the Link Editor refer to the "MODEL 990 COMPUTE?. LIl^^ EDITOR 
REFERENCE MANDAL", manual number 949617-9701 

8. 5-. 3 LINK EDITOR OUTPUT 

The listing produced by the Link 'Editor, using the Configurator 
generated Link Control File and the execution sequence as outlined 
above, will contain, the following: 1) a listing of the Link Control ^^ 

File, 2) any multiply defined symbols-, 3) the link map of the object 
modules included, and k) the link map the symbol definitions wthin 
these modules. Figure 8-2 illustrates a typical listing output of the 
Link Editor. 

Note that all listings produced by the Link Editor will indicate a 
series of multiply defined symbols encountered dxiring the linking 
process. This occurs because the final modu-le included from the 
library (ie., Z2ENDC) has eternally defined symbols corresponding to 
the entry points of ALL modules within th.e library. This prevents 
final automatic external reference resolution from automatically 
including ALL remaining modules in the library which were not 
explicitly DICLUDED, but were referenced by the STARTC/OBJ nodule. 
This will. -also eliminate the listing of unresolved references by the 
Link Editor. This results in the occurance of the multiply defined 
symbols in the output listing, but the actual linked object output 
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win Td€ correct and will have ijicluded the correct modules from within 
the library. (Refe' to Figure 8-2 on the following pages). 

8.6 TiJJGST (CONFIGURED) POWER BASIC APPLICATION 

Upon cofflpletion of Link Editor execution, the specified OUTPUT 
deyiee/file will -eontain the final Target POWER BASIC application 
object module. This object module should first be tested to verify 
its operation, and may then be prrigrazmed in EPROM's and placed in the 
final 1M990 target application. The following paragraphs will present 

?f i^^^^ ^^® ®^®P* ^ ^^« configuration of a Target POWER BASIC 
^ppjU. CE tl> on » 

8.6,1 AMPL CHECKOUT PROCEDURES 

^it^^^^^J^^ ^°\^ ^^® resulting linked object module (Target POWER 
BASIC application) into the target system RAM using AMPL. The target 
system must be configured such that there is RAM mapped where SPROM 
would ncrmally be in the target system (ie., beginning at 0000), and 
taat there is also additional RAM area for the workspace of the 
interpreter from hexadecimal address FFFFigon down in memory. Note 
that &MFI emulator memcT (EUM) is located at 0000 through IFFEi ', and 
can be sapped into the Target memory. Note that any acditiona^l HA^ 
required to replace the SPROM address space, must be acquired f^oa 
expansion memory boards. The workspace ares RAM for the apolicatlon 
will be acquired from the mierocoEputer board and anv additional 
expansion memory boards. 

The user may initialize the AMPL emulator, configure the emulator and 
trace memory, and then oad the Target POWER BASIC application using 
f ^^ J»oad program command as shown in the following example: 

EINT(»EM[JM 

EUMsON 

ElMsOFF 

LOAD («: TEST/SIS ',0) 

Note that the bias MUST be zero in order for the target application to 
be properly loaded. 
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txslmk: ' 

:0f1MAMD LIST 






1/00/ C'Ci 0'? : "^ / ! "'C» 



Ni:;ir?yMT 
NiriAuro 

LIBRARY .-CBASIC/LIB 
TASK CBASICJ 

.iNCi une s:?nARTrj/i:.tB.j 

INCLUDE (CALL)";) 

INCLUDfe (CMDB) 

IMCLUD€ (CV«'5C) 

INCLUDF? (1.HT) 

INCLUDE (ZZENDC) 
) NCLUn&;-"D?:C-2s THSTS/OB.. 

I NCl.UDE D^CZ : ABC / OB.. J 

I NCL IJDE DSCS s Bi;.:D/OB J 
END 



/?^i!B^ 



SYMBOL = CLLY i^HJiLH.H.fc:^: = .•:, 6 

SYMBOL MI..II...T .1. Pi. Y DEF ] Mfi J.t * N^k'-a w-?^W*W*W*W*W*W»Ui-irW-?. W« W-s iw*l,v*uH Wr 
SYMBOL = LEi'Y MOLHji .fe;-; = r^, 6 



TXSLNK 
LINK MAP 



'"? '•; 1 7:-; •7 AM. 



01/ 00 / 00 02 i'Z'/i ?0 



CONTROL FTLE = DSCri*. TtSTS/L NK 
LINKET) iniirPUT PILE = DSC2J rES75/SYS 
L]ST PILE - LP 

nurPMr format = ascli: 

LIBRARIES 

NO ORGANIZATION PAT HNAMH 

1 SEQUENTIAL sCBASIC/LCB 

FIGURE 8-2. I LINK EDITOR. EXAMPLE (Sheet • 1 of 3) 
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TXSLNK 



ael.l 76o2e« 



oi/i^o/oo oo:t?t2e 



Pk(;t 



PHASE 0. CPASK ORIGI*^ s 0000 LE'^STH s OFOfe 



MODULE 



MO offieiN 



STARTC 


I 


oodo 


CAULC 


2 


oee^ 


CVOfl 


3 


0BA8 


CV6C* 





ecFA 


LET 


S 


oDSe 


ZZENOC 


*> 


01^4 


ROOT 


7 


OEAg 


ABC 


8 .. 


. eF»A 


BCD •• ■ • 


■,•'«' •■ 


• 0F9i8 



LEW6TH 

OBO^ 
00^^ 
01B2 
OOSE 
01^2 
OOOE 
00E2 
OOOA 
'"0002 * 



TYPE 

INCtUOt 

IMCLU0£#1 

INCLUOt#l 

IWCLUDE/I 

INCLUOEf I 

INCLUOE^l 

INCLUOF 

JWCLUOe. 

INCLUDE 



DATE 

0l/02/7« 
01/03/7^ 
Ul/03/7^ 
01/03/79 
01/03/79 
Ul/03/79 

n/21/78 
12/18/78 



TIME 

lflsOrt:fti 
09251 :«6 
09;5?:51 
092b3s0fe 
09*56232 
10201:02 

I2:itt:?2 
12253:20 



C«EATCP 

SOSL^^K 
SDSLNK 
SDSL^'K 
SDSLWK 
SOSL^^H 
SDSL^JK 
COWFIG 
SDSMAC 
SOSMiC 



./NAME* r e 'VAL-DE-^er- 



VP .E. ILIA I T^l Q.hi.S . 

fiAM'r *va£Oe no- WAHE * 



ARC ' 


OFRA 


H 


ABSF 


0F9A 6' 


saDOF . 


ASCF 


0F9A 




«AS«0 


003C« 1 


»AS«1 


•601 


0961 




• 605 


OeoS I 


•W?0 


SASY 


OE<'A 




dAUO 


0E9A 6 


eCD 


eiTF 


(1E94 




elTt 


uE9A 6 


• 8US 


• Ca 


n«b2 




«CaAilO 


01FC 1 


«C6 


Ct<£X 


058<> 




•CLKAOR 


FE6C« 1 


CLKI 


♦CLKT02 


FE7tt. 




•CLKwS 


FP.6A. 1 


CLUTAB 


CQSf 


0E*^& 




CRSF 


Ot9t 6 


CP8Y- 


*CPPr 


OEOA 




cvsn 


0E9C e 


cvei 


CVCM 


PEEC« 




•evossp 


0C8? 5 


CVOIFZ 


•CVGCN 


OCFA 




CV6CN-1 


OD02 a 


«CvnO 


•CVHDIS 


FFOl" 




. *OATXB 


0201 1 


• OP" 


OlMY 


OF<«A 




«DLC 


0020* I 


• DLl" 


• DSl 


rE7C« 




»0S2 


FFHC» 1 


«DSi 


• EFUG 


0fl24« 




• ELM'' 


002E« I 


• EUS? 


• gNU** 


002C« 




•ESfet 


0F9A 6 


•£US 


•EVALS2 


075a 




EVA^Z 


0SB2 1 


FVERZ 


*£veP3A 


0?7I 




IVSOZ 


Q^Ti I 


•tvSF« 


♦EVSKE 


Fp9a« 




EXPff 


0?«A 6 


• FAD 


• KCLP 


oa«f 




• FBO 


0««2 I 


FFLS 


• FLOO 


0?3« 




•PUOAT 


0300 1 


«P»--|) 


• Fl^HM 


C52« 




«FNS 


OOOa* 1 


• FfJSZ - 


• FPAC 


FF9C« 




•FPAC2 


FF9e. 1 


•FPACa 


• FSCL 


OSafc 




• FSO 


023C 1 


• Fswn 


«FU2Z 


3?on« 




snsi 


0FA2 e 


cnsPi 


GPTY 


0E9A 




*GSC 


C01«* 1 


«GSS 


• rtFLS 


002«« 




«IFLG 


003A* I 


IFY 


INPF 


0E9A 




TNPY 


0F9A s 


«IKTFLG 


•IWTSS 


FE36* 




.iNrs» 


FFS8« I 


•IKTwPg 


rsTY - 


0€9A 




•ISTCK 


FF36« 1 


• ITA^ 


UANOF 


BE 94 




•use . 


0H2e« 1 


LfN-F 


♦ UTNf 


0160 




•LTnPO 


OtoF I 


•LINF2 


LNOTF 


Of OA 




• LN-S? 


oeHM* 1 


LOGF 


tXOBF • 


0e9A 


6 


vCnF 


Oe«16 6 


fl-P 


• MOOE 


no«n* 


1 


• NIC 


OOfetf* 1 


r.'KtF 



VA'CUE 


NO '■ 


♦iAHE 


•VALUE 


UC 


09B^ 




ANDF 


OE^A 


b 


003F.* 




aTwf 


0E9A 


t 


OlFE 




»«1F 


01FF 


1 


0F9i2 




♦ i^CPU 


003A« 


I 


oonc« 




• •CI 


09t»0 


1 


09e^A 




^CCJ^T 


002«* 


1 


oe9E 




»clktoi 


FE72* 


4 


0F$^, 




CLLY 


OBO^ 


2 


Of9A 




C^ff 


0F9A 


6 


0F«5C 




CVCIO 


0D22 


a 


O-^^C 




• CVCU 


(.»B^«. 


3 


Fcf2* 




•CVHOOl 


FEF5« 


I 


ons;?* 




DEFY 


uESA 


^ 


0OlF» 




»C55 


FElh^ 


1 


FFC?* 




♦ KnP 


FFF2» 


1 


D030« 




• hLSY 


OFOA 


n 


6002« 




• 5V4L 


07iC 


1 


OSCC 




• f.VFX 


O^E^ 


1 


07ia 




♦ EVS>^^ 


FF.F2» 


1 


1)2 « 6 




#FAL5PI 


OSlE 


1 


003?* 




• FIX 


0A82 


1 


n3b2 




♦ FMFG 


02Fh 


1 


jnoA* 




FOkY 


0E9A 


h 


FFAO* 




mFPv.P 


FF9C* 


I 


.022C 




• FSUBl' 


0^32 


1 


ofa;? 




ansY 


0€9A 


^ 


ooo^« 




♦ CS37 


ooia* 


1 


Of GA 




l^KY 


OFOA 


h 


►"PSb* 




m T :4 


0E9E 


^ 


FFaft. 




lOt* 


oono« 


I 


FElfctr 




•iTARa 


FEl.^* 


1 


0F9A 




LETY 


nD5^ 


5 


017?» 




•Ll^ES 


ouo 


1 


i}FQA 




LOkF 


OFVA 


e 


or9A 




Kff^r 


OE^A 


o 


0f«5A 


b 


rvLlN 


015A 


1 
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TXSL«<« 


/ 


2.3. 


A 7B.2a4 




ui/oo/00 00: 


lPs2fl . 






PAGE 


. 4 


NAME 


VALUf 


NO 


kamE 


VALUE 


«n 


NAME 


VAL»»E 


•^0 


UVAZ 


VALUe 


un 


• rJLINrO 


0156 


1 


nOTF 


OFQA 


eii 


t^•Pv 


000^* 


1 


♦ fjVU 


0012* 




♦ MVS 


00141* 


1 


«A*XTXS 


0200 


I 


imXTY 


UF9A 


h 


ONY 


OF^A 




OffF 


oe^A 


6 


♦ PFIX 


OADE 


\ 


• PLC 


OCIC* 


I 


• PLF 


003A* 




•POPY 


0E9A 


b 


prs^^ 


OEMA 


6 


p©TY 


OEOA 


^ 


*»AN03 


FEb6* 




RANOZ 


oeAii 


h 


RAhiY 


0E<9A 


^ 


WDUY 


OP 9 A 


'S 


♦ kEST 


013^ 




il^N^vY 


Of9A 


6 


POOT 


QFA^ 


7 


k'TWY 


of 9A 


o 


*SF5^* 


OAFO 




SINF 


or^A 


6 


«SUN 


OOafeti 


1 


•tSLT 


OOOE^ 


1 


SORF • 


0E9A 




♦ SOJ?I 


ooo«« 


I 


SPhF 


0F9A 


6 


trS5F 


FF7^. 


I 


♦ SUHF 


09OC 




SYSF 


0E9A 





*TFwe 


^F^^^ 


I 


♦Tf,v.P2 ■ 


FF9^» 


I 


• TEM^'a 


FFOfit 




♦ Tf:MP6 


FFQAt 


1 


TIC^ 


069A. 


5 


TT'^Y 


0e9A 


5 


TRPY 


0E9A 




nTYO 


oon* 


1 


«uFr 


8 * 


I 


• U^'S*^ 


0002* 


1 


• UNIT 


oniA* 




UNTY 


0£9A 





• 1/DT • 


0006. 


1 


♦ VM 


0030* 


1 


.-.PWl 


FFrtA* 




WPR103 


FEQi}* 


I 


^aOPio^ 


I^fe.y?* 


1 


wPh^Oa 


FF9A. 


1 


/.PW2 


FPOC* 





2 >lAflNlN6S 
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The user vill now simulate the RESET function by setting the workspace 
pointer (WP) and program counter (PC) to the values contained ^ in the 
BESET vector. For example.' 

IJPsfO 1 

PCs§2 

The user may now execute the application by entering thi start 
@si2lator command. For example: 

ERUN 

^- ^« users application should perform as it did during final system 

'^ test. In the event it does not, the user should request emulator 

status via the EST command. If the status indicated that an IDLE 
instruction is being executed, a fatal error has occurred in the POWER 
BASIC Interpreter. In the event this occurs, the user should halt the 
emulator (via the ISLl command) and display the workspace registers 
via the DR command. The user may obtain the error code ft'om register 
and the statement number where the error occurred from register 1. 
These values are displayed in hexadecimal and may assist the user in 
determining corective action for the error. Any errors detected in 
the application program will then be corrected is the original 
application of the Host POVER BASIC Interpreter and the ccnfiguratlon 
process must be executed again. Note that the execution of a STOP or 
ENS^statesent in the Application program will cause execution ef the 
IDLE statement. However, the error code and line number do not apply. 

If the application does not function correctly and a fatal error is 
not indicated, the user should verify the correctness of the memory 
^m>. map, and the correct function of the target application hardware. 

The target memo.^y may be verified using AMPL target memory display 
statements. Application hardware operation may be partially verified 
through the use of the CRU instructions supported by AMPL. If the 
target memory map is correct and the application hardware functions 
correctly, the user should return to the Host POWER BASIC Interpreter 
and attempt to debug the application interactively. If the 
application functions correctly on the Host POWER BASIC Interpreter 
but does not operate correctly in the "configured" target application, 
the user should contact the local TI distributor. 

8. 6% 2 PROGRAMMING USING TXPROM UTILIir •- 

The Target POWER BASIC application my then be programamed into EPHOM 
using the TXDS prom programmer utility program (TXPROM)-. To use] this 
utility, the user must recall: 1) that the resultant object dodule 
(Target POWER BASIC application) produced by the Link Editdr is 
relocatable, and 2) that the Target POWER BASIC application must 
reside in the TM990 system beginning at location 0000. 
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The user oust define the PROGRAM and VERIFY control files used by '•he 
prom prograaaer utility to reference the resultant linked oje"ct 
module. The user will also typically define the control files to 
program the application into TMS2716 EPROM's. As the user 
programs each EPROM, it must be appropriately marked as the high or- 
low order byte and with appropriate memory address location. The user 
aiay also mark them with the U-numbers (U42-U45) as they are to be 
placed en the microcomputer board. 

For complete information on the use of the TXPROM utility, refer to 
Section 10 of the MC3DEL 990 COMPUTER TERMINAL EXECUTIVE DEVELOPMENT 
SYSTEM PROGRAMMER'S GUIDE entitled "TXDS PROM (TXPROM) Programmer 
Utility Program"; 



8.7 EXAMPLES 



The user should refer to Appendix E for examples of the configuration 
process. These examples will illustrate the entire configuration' 
procedure* From the application program "SAVEd" in a diskette file by 
the Host POWER BASIC Interpreter , to execution of the final Target 
POWER BASIC application. 



_,,«««^Ev 
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SECTION EC- 
INSTALLATION OF TARGET POWER BASIC APPLICATION 

9.1 INTRODUCTION 

Once the user has programmed the Target POWER BASIC Interpreter into 
EPROM (using the procedures as outlined in Section 8, paragraph 
8.5.2), the user will need to insert these EPROM»s into the 
Microcomputer board, as well as appropriately configure the TM990 
system for use with the final Target POWER BASIC application. This 
section will present the EPROM installation procedures and the initial 
system set-up for use in a Target POWER BASIC application. Note that 
only .the- general system requirements for the execution of the Target 
POWER BASIC Interpreter in a TM990 system will be specified, and that 
any additional application dependent board configurations must be 
performed by the user. 

9". 2 GENERAL SYSTEM CONFIGURATION 

The Target POWER BASIC application will reside in EPROM starting at 
the address of 0000 and will occupy as many EPROM* s as required to 
store the interpreter and application. The EPROM' s must be inserted 
in the system at the starting address of 0000 ^ 5 since POWER BASIC 
utilizes the XOP's and the interrupt vectors. These EPROM' s will 
reside on the TM.990/101M or TM990/100M Microcomputer board. If more 
than four EPROM 's are required, the user will place those remaining on 
a TM990/201 Expansion Memory Board. 

The Target POWER BASIC application also requires some RAM area in the 

TM990 system for Interpreter overhead, and for storage of variables 

and arrays referenced by the application program. The Target. 

Interpreter requires that the RAM area begins at hexadecimal address 

FFFF and expands on down in memory (ie., toward address 0000). The 

TM990/101M and TM990/100M Microcomputer boards (when fully populated) 

contain RAM from FFFF^g down to FOOO.g (4k bytes) and from FFFF,. down 

to FCOOjgdK bytes), respectively. In many applications, the on-board 

RAM of the TM990/101tl Microcomputer will fulfill the system 

requirements. However, additional expansion RAM is required in all 

IM990/100M board systems, or when large applications are "configured" 

for execution in a 1M990/101M system. In both cases, a TM990/201 or 

TM990/2Q6 Expansion Memory Board will be used to expand the RAM area 

from hexadecimal address EFFF^g on dovra. Note that the Target POWER 

BASIC Interpreter will appropriately comprehend and compensate for the 

resulting "hole" in RAM (from. FOOO^- up to FBFF,g) when a TM990/100M 

board is used in the application system with an expansion memory 
board. 



/-<**>. 
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9.3 EQUIPMENT REQOIHEMENTS 

The required equipment and options of the Target application system 
ai^e described in the following paragraphs . 

9.3-. 1 MICROCOMPUTER BOARD 

One of the following fflicroeomputer boards will be required: 

• 1M990/101M (-1, -2, -3, or -10) Microcomputer Board 
,• TM990/100M (-1, -2, or -3) Microcomputer Board 

r" 9.3.2 OPTIONAL BOARDS 

The user may optionally configure any of the following boards in the 
system: 

• TM990/201 (-41, -42, or -43) Expansion Memory Board ' 

• 1M990/206 (-41 or -42) Expansion. Memory Board 

• ^990/310 I/O Expansion Board 

In addition, the user may configure any special purpose, application 
dependent boards into the system as required. 

9.3.3 POWER SUPPLY 

The power requirements of the boards that are typically used in system 
configurations are listed in Table 9-1. The power supply must be 
capable of supplying the total reqiiired current and voltage levels of 
the selected system configuration as a minimum. It is recommended 
that current ratings of the power supply be specified above the 
minimum to avoid prolonged use of the power supply at or near its 
rated maximum. Regulation must be 355 on all supplies. 

9.3.4 CHASSIS 

The use of a TM990/510 4 slot chassis, TM990/520 8 slot chassis, or 
equivalent is necessary for the set-up of the Target POWER BASIC 
-- • application, since typically more than one board is required in most 

applications. 



9-2 



Alternately, the following 100-pin, 0.125 inch (center-to center) PCB 
edge connectors may be used to interface with connector Pi. such as 
wire wrap models: 






TI H321 150 
AMPHENOL 225-804-504 
VIKING 37H50/9CND5 
ELCO 00-6064-100-061-001 



9.3.5 TEBMINAL AND CABLES 

The Target POWER BASIC appUcation may include communications (either 
keyboard input or printer output) with a terminal device. If a 
terminal device is not required in the particular application, the 
user iijay .proceed to the next paragraph. ' 

Sr'mlS'devJS^:^^"^' Interpreter will support the foUowing types of 

• RS-232-C compatible terminal (using a TM990/502 cable), or the 
TI ASH 733 (using a TM990/505 cable) : see Appendix B of the 
'TM990/10pM' or 'TM990/101M Microcomputer User's Guide' to 
verify the cabling you have or for instructions to make a 
custom cable. 

• TI. 743/745: See Appendix B of the 'TM990/100M' or 'TM990/101M 
Microcomputer User's Guide' for special cabling requirements. 
The TM990/503 cable may be used to interface a 743/745 
terminal. 

• Teletype Model 3320/5JE (for TM990/100M-1 , TM990/101M-1 , and -3 
microcomputer boards only): see Appendix A of the 'TM990/100M' 
or ♦TM990/101M Microcomputer User's Guide' for required 
modifications for 20 mA neutral current loop operation and 
proper cable connections to the. TM990/504 cable. 

TABLE 9-1 
TM990 MICROCOMPUTER FAMILX POWER CONSUMPTION 



TM990 CIRCUIT BOARD 



i^AX" 



/100M CPU BOARD 
/101M CPU BOARD 
/201-41 MEMORY BOARD 
/201-42 MEMORI BOARD 
/2OI-43 MEMORY BOARD 
/206-41 MEMORY BOARD 
/206-42 MEMORY BOARD 



CURRENT REQUIREMENTS 



5V 



1.4 
2.6 
2.5 
3.0 
5.5 
2.5 
5-. 5 



TYP 



1,0 

1.2 

1.0 

1.4 

2.15 

1.3 

2.15 



12Y 



MAX 



.3 

.5 

.18 

.38 

.75 

X 

X 



TYP 



.2 

.25 

.16 

.23 

.48 

X 

X 



MAX 



.3 
.4 

.5 
-.55 

.7 
X 

X 



27 



TYP 



.2 
.2 
.05 
.13 

.23 
X 

X 



^fSW**! 



,y*«©V 
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A 25-pia RS-232 male plug, type DB25P, is reqxzired if an interface 
eable is not purchased. 

NOTE 

POWER BASIC requires use of a standard DSASCII coded terminal device. 
Most terminals use this standard character code. Also, be sure that 
the correct cable assembly is used with your data terminal. For 
teletypewriters (TTY), refer to Appendix A of the 'TM990/100M' or 
»IM990/101M ittcrocompute? User's Guide' for the signal configuration 
used by the main I/O port. 



9.4 SISTEM SETUP 



This section describes the steps required to set-up the system for 
execution of the Target POWER BASIC application. 



9.4.1 POWER SUPPLI CONNECTIONS 



Figures 9-1 and 9-2 illustrate power supply hookup by connection to a 
lone 100 pin edge connector and by installation in a card chassis, 
respectively. Only the ^990/101M microcomputer board is displayed in 
the figures. However, the figures are applicable' to both the 
TM990/100M and the TM990/101M microcomputer boards. 

Figure 9-1 shows how the power supply is connected to the micro- 
eosputer board through connector PI, using a 100-pin edge connector. 
Be careful to use the correct pins as numbered on the board ; these pin 
numbers may not necessarily correspond to the numbers on the 
particular edge connector used. Check connections with an ohmmeter 
before applying power if there is any doubt about the quality or 
location of a connection. 

The table in Figure 9-1 shows suggested color coding for the power 
supply plugs. To prevent incorrect connection, label the topside of 
the edge connector "TOP" and the bottom "TURN OVER". 

For power connection to one of the chassis, look at the backside of 
the backplane, find the connections for each of the supply voltages 
and connect them to the power supply. Be sure to turn power off 
before installing or removing any boards from the chassis, 

CAUTION. 

BEFORE connecting the power supply to the microcomputer, use a 
volt-ohmmete* to verify that correct voltages are present at 
the power supply. After verification, switch the power supply 
OFF, .and then make the connections to the chassis as shown in 
Figure 9-2-. The correct voltages should also be verified at 
the chassis or edge connector prior to insertion of a board. 
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TM 99/101M 

F1 CONNECTOR 

(TOP) 

SO 



> > 

I 



DDOQOQDODDDOODonnoooooDDononnilnnnnnDDDDaoannnnnnnfif 




y^!B»v 



VOLTACS 

♦12V 
-12V 



PI PIN* 



SU6GSSTSO PLUG COLORS 



3,^4«97,98 

75,76 

73,74 

1.2,99.100 



RED 

BLUE 

GREEN 

SLACK 



•ON 8CAR0. OOfrNUMaSRED PADS ARE DIRECTLY BENEATH EVEN-NUMBEREO PADS. 
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FIGUHE 9-T. POWER SUPPLY HOOKUP 
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FIGURE 9-2. IMggO/lOlM BOARD IN TM990/510 CHASSIS 



9.1i.2 EPRCM INSERTION 

The user should carefully remove all EPROM chips fron the board (in 
sockets U42, D43, 044, and D45) if present, and place them 'in 
conductive foam for safe keeping. The user should then remove the 
Target POWER BASIC application EPROM 's from their conductive foam one 
at a time, beginning with the one marked as 042 by the user, and care- 
fully insert them into the appropriate sockets on the microcomputer 
board. Make sure they are placed in the correct sockets, and that pin 
(^ 1 of the EPROM 's match with pin 1 as marked by the silkscreen on the 

board. Carefully inspect each EPROM to ensure that all pins have 
seated correctly into the socket and that none have bent under the 
device. Be careful to avoid bending the pins at all times. Bent 
EPROM pins are the number one cause of "mysterious" board failures. 

If more than four EPROM's are required, place the additional EPROM's 
into the appropriate sockets of the TM990/201 expansion memory board. 
Note that the TM990/201 board must be. configured with EPROM starting 
at hexadecimal address 2000i6 as shown by the switch settings of 
Table 9-6. The expansion EPROM's will then be placed in the 
corresponding sockets of the memory board so that they reside from 
.• -memory address 2000^6 through the address corresponding t© the last 
EPROM of the Target application EPROM set. For additional information 
refer to paragraph 9.4,4, Expansion Memory Board switch settings. 
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9. 4-. 3 MICHOCOMPUTER BOARD JUMPER SETTINGS 

The user slxould appropriately connect and verify that the jumper 
configurations on the TM990/101M or TM990/100M board ai^ as described 
in Table 9-2 or Table 9-3", respectively. Figures 9-3 and 9-4 show the 
board locations of these jumpers for reference. 

For the user who requires detailed jumper placement information, refer 
to Tables 9-4 and 9-5 for the TM990/101M and TM990/100M boards 
respectively. 



TABLE 9-2 
1M990/101M JUMPER SETTINGS 



Jumper 



E1-E2-, E4-E5, E8-E53, E9-E10, 
E13-E14, E16-E17, E26-S27, E28-E29 
E31-E32, E33-E34, E39-E40, E54-E55 

E36-E37 

All other jumpers 



Comments 



Required 



Install for TTY 

Remove for EIA RS-232-C 

Don't care 



TABLE 9-3 
TM990/100M JUMPER SETTINGS 



/<^^ 





Jumper 


Jumper Setting 






J1 


P1-18 






J2 


2716 






J3 


16 






J4 


16 






J5-J6 


Don't care 






JT 


EIA .. 






J8-J10 


Don't care 






. J11 


Install for TTT 

Remove for EIA RS-232-C 






J12-J18 


Don't care 
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TABLE 9-4 
TM990/101M BOARD JUMPER POSITIONS 



Interrupt 4 Source 



FUNCTION 



JUMPER 
POSITION 



EXPLANATION 



E1-E2 Connects INT 4 to pin 18 of PI edge con- 
nee tor 



Interrupt 5 Source 



E4-E5 Connects INT 5 to pin 17 of PI edge con- 
nee tor 



Slow/Fast EPROM 
270^/2716 Memory Map 



E8-E53 Causes no WAIT states: memory cycles 
are full speed 



E9-S10 Selects memory map for TMS2716 EPROM ^s 



iPROM Enable 



3I/L0 Memory Map 



i1a 'Connector Ground E18-E19 



^croterminal +5 V 



^cro terminal +127 



(dicro terminal -127 



E13-S14 On-board EPROM is enabled into memory map 



E16-S17 EPROM at low address, RAM in high 



Connect PIN 1 of Connector P3 to ground. 
When using as an auxiliary serial I/O 
device, consult that devices manual con- 
cerning grounding. Normally, this jiomper 
is installed 



E20-E21 Micro terminal Power :*5 V to pin 14 of P 2 
edge connector (See note 1) 



E22-E23 Microterminal Power:+12 V to pin 12 of ?2 
edge connector (see Note 1> 



2708/2716 Addressing 



Teletype* 



E24-E25 Microterminal Power: -12 V to pin 13 of P2 

edge connector (See note 1) 
E26-E27 Main EPROM is IMS2716 ^ 

E28-E29 Main EPROM is TMS2716 
E31-E32 Expansion EPROM is TMS2716 

E33-S34 Expansion EPROM is TMS2716 ^ 

E36-E37 REMOVE this jumper if using an RS-232 de 

vice. If using a teletype device connect- 
ed to Port 2, INSTALL this lumper 



deceive select E39-E40 



This jumper should be INSTALLED when an 
RS-232 or TTY device is connected to port 
P2. The multidrop interface is normally 

^ not used with POWER BASIC 

Multidrop Termination** E41-E42 These are the connectors for the multi- 

E45-E46 d2?op termination resistors. These jumpers 

E49-E50 should be REMOVED since the 'multidrop in- 

E51-E52 terface is normally not used with POWER 

BASIC 



Multidrop Half Duplex** E43-E44 



F'i Port Mode 



654.^53 



These jumpers should be REMOVED since 
multidrop half duplex operation is type-^ 
cally not required with POWER BASIC. 



Connects TMS9902 RTS to CTS for port P3 
to communicate with an RS-232 compatible 
terminal. 



* ' On TM990/101M-1 and -3 only 
** On TM.990/101M-2 only 
Note Is These jumpers should be removed since the TM990/301 microterainal 
is not used. (May be left installed for certain terminals, €cg. , 
TI 743.) 
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TABLE 9-5 
TM990/100M BOABD JUMPER POSITIONS 



FUNCTION 



Interrupt 4 Source 



2708/2716 Memory Map 



Multidrop Interface 



JUMPER POSITION 



EXPLANATION 



J1 



»P1-18« Connects INT 4 to pin 18 of PI 
edge connection 



EPROM is TMS27l6«s 



These jumpers should be REMOVED 
since the multidrop interface 
is nonnally not- used with POWER 
BASIC, 



J2 


••2716" 


J3 


»16« 


J4 


«16W 


J5 


Out 


J6 


.Out 


J8 


Out 


J9 


Out 


J10 


Out 


J12 


Out 



EIA/Multidrop Select 



Micro terminal Power 



Spare Jumpers 



X - Don't care 



J7 



J13 
J14 

J15 



J16 
J17 
J18 



"EIA" 



20mA/RS-232 Interface J 11 In/Out 



An RS-232 or TTY' device is nor- 
mally connected to the serial 
port (jumper INSTALLED). 

REMOVE this jumper is using an 
RS-232 device. If using, a TTX 
device, INSTALL this jumper. 



In/Out These jumpers should be REMOVED 
In/Out since the TM990/301 microtermi-r 
In/Out nal is not used with this system, 
(May be left installed for cer- 
tain terminals, e.g., TI 743.) 



X 
X 
X 



Spare jumpers , irrelevant to sys« 
tem operation. 



^ 
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9.4.4 EXPANSION MEMORI BOMD SWITCH SETTINGS 

The IM99Q/2d3 ©r IM990/206 expansion memory boards may be configured 
into the mm sytem to provide either or both expansion RAM and/or 
expansion EPROM for the Target POWER BASIC application. Figures 9-5 
and 9-6 present the switch settings and corresponding memory addresses 
for the RAM and EPROM of the TM990/201 board, while Figure 9-7 
presents the switch settings for the RAM of the IM990/206 board. When 
setting the switches of these boards, the user should be careful not 
to overlap memory areas on a single board or between boards in the 
system. The following paragraphs will present the switch settings for 
configuring RAM and/or EPROM into the Target application system. 

The user will configure expansion EPROM into the TM990 system when 
additional EPROM area is required to physically place the Target POWER 
BASIC application EPROM set into the system. The EPROM area on the 
mcrocomputer board resides from hexadecljaal address 0000 through 1FFF 
therefore the expansion EPROM area must begin at hexadecimal address 
2000 and will continue to the highest address required to store the 
Target appUcation. The TM990/201 board will be used to provide this 
additional EPROM area for the system. Table 9-6 presents the DIP 
switch settings to configure an additional 8K bytes of EPROM into the 
system as well as an additional 4K, 8K, or 16K bytes of RAM. Note that 
either the -42 or -43 versions of the memory board may be configured 
to include up to 32K of EPROM area if required to store the Target 
Interpreter/application. EPROM area not required in the system is ^ 
recosmjended to be disabled to prevent memory area overlap. 

The user may expand the RAM area of the system by configuring 
additional TM990/2G1 or TM990/206 memory boards into the system 
Additional RAM area will provide more user variable storage for the 
application program resident in the system. Addition of RAM does not 
require any modification to the Target Interpreter or to the Micro- 
computer board if configured as described in the preceeding sections 
l°lt ^^* ^^® ^-^ on the Microcomputer board resides from FOOO, «■ to 

?hf\ir^et'pow?t^^«.^^?i''V ? ^''^^ ^^°°16 to FTFF16 on the TM990/io^OM. 
The target POWER, BASIC Interpreter upon initial power-up will 
automatically size for all available contiguous RAM starting from 
FFFFig and continuing on down in memory a word at a time until a 
write/read mismatch is detected. This therefore requires that the top 
^feH® expansion RAM be located at hex location EFFFig if the POWER 
BASIC Interpreter is to locate and use the expansion RAM, and may 
continue on down in memory as far as required by the user»s 
. application. Note that the Target POWER BASIC Interpreter will detect 
^^^^^^f ^^^®^y compensate for the "hole" in RAM (from FOOO, ,up to 
FBFFig) w^«a a TM990/100M board is used in the application syslem with 
, an. expansion memory board. Table 9-7 presents the DIP switch settings 
to- configure additional RAM from either the /201 or/206 board into the 
system. Note that these switch settings configure all RAM that is 
available on the particular version of the memory board into the TM990 
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TABLE 9-6 
1M990/201 EXPANSION EPROM CONFIGURATIONS 






MEMORI 
■BOARD 



TM990/201-41 



TM990/201-42 



TM990/201-43 



EXPANSION 

EPROM 

£ WORBS 



4K X 16 



4K X 16 



4K X 16 



EXPANSION 

RAH 

K WORDS 



2£ X 16 



4K X 16 



8K X 16 



SWITCH SETTINGS 

SI S2 S3 Sk...S5 S6 .ST S8 



ON ON OFF OFF OFF ON OFF OFF 



ON ON OFF OFF ON ON ON OFF 



ON ON OFF OFF ON ON ON ON 



y1^\ 



TABLE 9-7 . 
RECOMMENDED RAM EXPANSION CONFIGURATIONS 



MEMORY 
• BOARD 


EXPANSION 

EPROM 

K WORDS 


SXPANSlOlJ 
RAM 
K WORDS ■ 






SWITCH SETTINGS 


SI 


S2 


S3 


S4 .35- SO S7 3d 


* 
IM990/201-41 


4K X 16 


2K X 16 


OFF 


OFF 


OFF 


OFF OFF ON OFF OFF 


* 
TM990/201-42 


8K X 16 


4K X 16 


OFF 


OFF 


OFF 


OFF ON ON ON OFF 


* 
TM990/201-43 


16k X 16 


8K X 16 


OFF 


OFF 


OFF 


OFF ON ON ON ON 


IM990/ 206-41 


X 


4K X 16 


X 


X 


X 


X ON OFF OFF OFF 


TM990/206-42 


X 


8K X 16 


X 


X ' 


X 


X OFF OFF OFF ON 



X - NOT APPLICABLE 

* - The switch settings to disable all expansion EPROM memory from the 
system are. S1-S4 all OFF. 
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ppoois 



2OOO1 6 



2EFE16 
FOOO 1 6 



FFFF 16 



EPROM 

ON 1M990/101M BOAED 

4K X 16 



EXPANSION EPROM 
TM990/201 



f 



EXPANSION RAM 
TM990/201 
or TM990/206 



y 



RAM 
ON 1M990/101M BOARD 
2K X 16 



EPROM 
ON TM990/101M BOARD 
4K X 16 



i EXPANSION EPROM 
TM990/201 



EXPANSION RAM 
TM990/201 
or TM990/206 



y_ 



UNUSED 



RAM 
ON TM990/100M BOARD 
512 X 16 



0000 1 6 



2000 



16 



y#«^5v 



EFFE 



16 



y^*^ 



FCOO 



16 



FFFF 



16 



IM990/101M 
WITH EXPANSION RAM 
AND EPROM 



1M990/100M 

WIIH EXPANSION RAM 
AND EPROM 



FIGtfRE 9-8 TARGET POWER BASIC APPLICATION MEMORY MAPS 
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Figure 9-8 depicts the original asenory map of the Target POWER BASIC 
application, as well as the EPROM and RAM memory expansion areas 
described earlier in this section. 

?.4-.5- BOARD INSERTION AND TERMINAL HOOKUP '" 

These procedures assume that the Target POWER BASIC application 
EPRQM's are resident in the required address space as described in 
paragraphs 9. 4-. 2. Also if the application requires the user of a 
terminal device, a terminal and cable of the proper type to match the 
serial interface must be employed (refer to section 9.3.5). 

CAUTION 

.- ' Be very careful to apply the correct voltage levels to the 

TM990 system. A volt/ohmmeter should be used to verify power 

supply voltages and connections. Boards should never be 

• inserted in or removed from a system the pover applied. This 

is also true for front edge connections (I/O ports, etc.) 

Texas Instruments assumes no responsibility for damage caused by 
improper wiring or voltage application by the user. 

9.4.5.1 BOARD INSERTION 

Figure 9-9 shows how to correctly place the microcomputer board in the 
TM990/510 card chassis. Slot 1 of the chassis is reserved for the 
aierecomputer board because termination resistors for the control bus 
signals are at the opposite end of the backplane. Slide the 
ffiieroeomputer board into the slot, following the guides. Be sure the 
aierecomputer board PI connector is correctly aligned in the socket on 
the backplane, then gently but firmly push the board edge into the 
edge connector socket. 

The second board in a Target POWER BASIC application should be 
inserted in the next slot down, although this is not critical. 




FIGURE 9-9. IM990/101M BOARD IN TM990/510 CHASSIS 
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9.4.5.2 TERMINAL HOOKUP 

If the Target POWEH BASIC application utilizes a terminal device for 
either keyboard input or printer output, the user should perform the 
following procedures. All keyboard inputs must originate ft-om port A 
of the TM990/101M Microcomputer board, while any outputs may be 
directed to either or both ports A and/or B through use of the UNIT 
statement of POWEH BASIC. All keyboard input and/or terminal output 
will be directed through the single port of the TM990/TdoM 
Microcomputer board. 

Figtare 9-10 shows how the microcomputer board is connected to the 
H 743 KSR terminal through connector P2. A DE15S connector attaches 
to the 'terminal? a DB 25P connector attaches to P2 on the board. 
Point-to-point connections between the connectors are shown in the 
teble in Figure 9-10. Figure 9-11 shows a RS-232 terinal (eg., ^ 

H 733), and Figure 9-2 shows a TTI, connected to the TM90/101M board 
through connector P2. All terminals connected to the microcomputer ■ 
will have a similar hookup procedure and point-to-point configuration. 
For the differences between terminal cables, refer to Appendices A and 
B of the "rM990/101M' or 'TMggo/IOOM Microcomputer User's Guide'. 

The target POWER BASIC application .may operate the EIA/TTY ports at 
any of the foUowing baud rates: ^ 

100, 300, T200, 2U00, 4800, 96OO, or 19200 baud 

To utilize the EIA/TTY port(s) of the microcomputer board, the user 
must perform, initialization of the TMS9902 Asynchronous Communications 
Controller to the desired baud rate corresponding to the baud rate of 
the terminal device.. The user performs this initialization by 
including the BAUD statement within the application program before it 
is "configured" into the Target POWER BASIC application. The user 
must perform this initialization of port A of the board if it is to be -^ 

used for keyboard input, and must also perform the initialization on 
either or both ports A and B if these are to be used for terminal 
output. The user may then direct all. output of the Target application 
by using the UNIT statement within the application program. 

The TMS9902 asynchronous communication controller is initialized for 
seven-bit ASCH characters, even parity and two stop bits. 

The^ Target POWER BASIC application also uses conversational 
full-duplex communication. Set the communications mode of your 
terminal to FULL DUPLEX, and set the OFF/ON LINE switch to ON LINE or 
. the functional equivalents. 

Note that there is a 200 ms. delay following a carriage return output 
for all baud rates at or below 1200 baud. This delay allows for 
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TO 7^ DATA 
TERMINAL 



4 CONDUCTOR CABLE. 24 AW6 
INSULATED STRANDED WIRE 



A0001418 



CONNECTIONS 


f IN ON 0E1SS 


Pm ON QBZSP 


SIGNAL 


13 


2 


XMIT '. 
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FIGURE 9-10. 743 KSR TERMINAL HOOKUP 




FIGURE 9-11. CONNECTOR P2 CONNECTED TO RE-232-C DEVICE (MODEL 722 ASR) 
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printhead travel. Also note that 1200 baud output is effectively 
converted to simulate 300 baud output by insertion of three cha;racter 
wait times between each character output. This i occurs bn all 
terminals operating at 1200 baud. This enables proper terminal 
printer response and prevents thermal printhead overheating ytien using 
the H Silent 700 Series of data terminals. \ 

■I 
9.5 OPEHATION ■ 

9.5.1 SYSTEM VERIFICATION ' 
Verify the following conditions before applying power to the system: 

•Power connected to correct pins on PI connector 

• Jumpers In correct positions (see paragraph 9.4.3 and 9.^.4) 

• All application requirements are correctly implemented in the "^ 
system 

• Terminal (if used) connected to correct port on microcomputer 
board 

• Baud rate of terminal (if used) corresponds to that set in 
user^s application program. 

• Communications mode is correctly set at terminal and terminal is 
ON LINE (if used) 

9.5.2 POWER-OP/RSSET 

To power-up and initialize *a Target POWER BASIC application, the user 
must perform the following sequence. This sequence assumes that the 
application program has been extensively tested on the Host POWER 
BASIC Interpreter before "configuration'*, and very likely has also 
been tested in the final application via the AMPL system. This 
reasonably ensures that the Target POWER BASIC application to be 
executed in the final TM990 system is a valid, executable POWER BASIC 
Interpreter and application. This is necessary since the user will 
have very little debug capability of the configured application and 
interpreter at this stage of the cycle. Therefore the user should be 
reasonab^ly able to assume that the Target POWER BASIC 
Interpreter /application is at least functional, and should begin 
execution upon completion, of the following power-up sequence. 

1) Apply power to board and data terminal (if used) 

2) Activate the RESET switch near the comer of the microcomputer 
board 

This should cause the Target POWER BASIC Interpreter to begin 
execution. The interpreter will first performi internal, POWER BASIC 
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system initialization, followed by execution of the application 
program. 

The user will then need to verify that the appUeation is actually 
performing the required functions, and should perform a series of 
tests to check its operation under many conditions and at the limits 
of its ranges for operation. 

If the Target POWER BASIC interpreter/appUeation fails to correctly 
respond to the preceeding sequence, repeat the sequence, and if it 
does not respond correctly, proceed to paragraph 9.6 below. 

9.6 DEBUG CHECSLIST 

If the Target POWER BASIC application does respond correctly, turn the 
r^ power OFF. Do not turn the power ON again until you are reasonably 

sure that the problem has been found. The following is a checklist of 
points to verify. 

• Check POWER circuits? 

- Proper power supply voltages and current capacity. 

- Power connections from the power supply to the PI edge con- 
nector. Check pin numbers on PI. Check plug positions at 
connections. Make sure board is seated in chassis or edge 
connecter socket correctly. 3e certain that the edge connec- 
tor socket (if used) is not upside down. 

• Cheek TERMINAL connection (if used): 

- Proper cable hookup to P2 connector and to terminal. Verify 
with data in Appendices A and B of the ''TM990/101M" or 
"IM990/100M User's Guide". One of the most common errors is 
that the tenoinal cable is not plugged in, 

- Check for power at the terminal. This is another common 
error - the terminal is not turned ON. 

- Terminal is in ON LINE mode, or equivalent. 

- Terminal is in FULL DUPLEX mode, or equivalent. If the 
terminal is in HALF DUPLEX mode , it will print everything you 
type twice, or it may print garbage when you type. Put the 
terminal in FULL DUPLEX mode. 

- EIA/MD jumper in EIA position. 

- Cheek BAUD RATE of terminal - it must be 110. 300 1200 
2400, 4800, 9600, or 19200 BAUD. ' ' 

• Check microcomputer board jumper plug positions against Table 
9-2 or 9-3 « 

• • Cheek expansion memory board switch positions against Tables 9-6 
or •9-7. 
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• B€ ^ure Target POWEH BASIC application EPROM's are in plaee 
eorr^ctly, 

• Verify that all application requirements in the system are 
correctly implemented. 

• Chee^ all socketed parts for correctly iaserted pins. Be sure 
ther^ aren't any beat under or twisted pins. Check pin 1 loca- 
tions. 

If the problem cannot be detected, reapply power and try to feel the 
components for excessive heat. Be careful as bums may occur is a 
defective component is found. If the cause of failure cannot be 
found, it is suggested that the user verify that the EPROM's have the 
.correct contents by using the TXPROM utility of the TX990 system, and 
.have not "lost" any values since they were "programmed. If the EPRCM's 
are correct, the user may use AMPL in the system with the final Target 
PC3WEH BASIC application resident in EPRQM to verify various parameters 
and segments of the program (eg., CRD inputs/outputs, monitoring of 
temiaal values output on the CRU, verification of operation of any 
"CALLed" assembly language routines, etc.). If the problem still 
cannot be found, the user should return to the Host POWER BASIC 
Interpreter and perform additional tests to verify the validity of the 
application programmed into this application. If the user discovers 
that the application program functions correctly on the Host POWER 
BASIC Interpreter, but does not operate correctly in the configured 
target application, and the user is reasonably confident that the 
application program is correct to perform the target application, the 
user should contact the local TI distributor. 
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APPENDIX A 

HOST POWER BASIC INTERPERTER; ERROR MESSAGES 
POWER BASIC. CONFIGURATOR ERROR CODES • 
: TX990 OPERATING SYSTEM ERROR CODES 
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APPENDIX A-1 

HOST POWER BASIC INTERPRETEB ERROR tSSSAGES 

The following error messages aay be issued by the HOST POWER BASIC 
Interpreter: 

CODE ERROR MESSAGE 

1 s SYNTAX ERROR 

2 s UNMATCHED DELIMITER 

3 s INVALID LINE NUMBER 

4 s ILLEGAL VARIABLE NAME 

5 s TOO MANY VARIABLES 

6 = ILLEGAL CHARACTER 
■.-7's EXPECTING OPERATOR 

8 s ILLEGAL FUNCTION NAME 
*^ 9 s ILLEGAL FUNCTION ARGUMENT 

10 s STORAGE OVERFLOW 

11 s STACK OVERFLOW 

12 s STACK UNDERFLOW 

13 s NO SUCH LINE NUMBER 

14 s EXPECTING STRING VARIABLE 

15 s INVALID SCREEN COMMAND 

16 g EXPECTING DIMENSIONED VARIABLE 

17 s SUBSCRIPT OUT OF RANGE 

18 s TOO FEW SUBSCRIPTS 

19 = TOO MANY SUBSCRIPTS 

20 £ EXPECTING SIMPLE VARIABLE 

21 s DIGITS OUT OF RANGE (0< # of digits <12) 

22 s EXPECTING VARIABLE 

23 s READ OUT OF DATA 

24 £ READ TYPE DIFFERS FROM DATA TYPE 

25 s SQUARE ROOT OF NEGATIVE NUMBER 

26 s LOG OF NON-POSITIVE NUMBER 
f^ 21 s EXPRESSION TOO COMPLEX 

28 s DIVISION BY ZERO 

29 s FLOATING POINT OVERFLOW 

30 s FIX ERROR 

31 s FOR W/0 NEXT 

32 s NEXT W/0 FOR 

33 s EXP FUNCTION HAS INVALID ARGUMENT 

34 = UNN0RMALI2ED NUMBER 

35 s PARAMETER ERROR 

36 s MISSING ASSIGNMENT OPERATOR 

37 s ILLEGAL DELIMITER 

38 £ UNDEFINED FUNCTION 

. 39 s UND33ffiNSIONED VARIABLE 
4Q s UNDEFINED VARIABLE 

41 s INVALID END-OF-USER RAM ADDRESS - ... 

43 s INVALID BAUD RATE -: -. I.: •.-..:: r.-— ! 
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The following err'pr messages result from the POWER 3ASIC/TX990 
Operating Syistem Interface? 

50 s END-OF-FILE OCCURRED 

51 = TABLE \AREA FULL! 

52 s INVALID; LDNO 

53 s INVALID PATHNAMfi 

54 s ZERO LENGTH RECORD 

55 a INVALID FILE ACpESS 

56 s POSITION ERROR ! 

57 s INCQMPATABLE F^E TYPE 



NOTES The TX990 Operating System error codes as presented in Appendix 
"•'A°3 laay also result during execution of ,the HOST POWER BASIC 
Interpreter, 
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APPENDIX A-2 
POWEH BASIC CONFIGURATOR ERROR CODES 



The Configurator eaa report most of the error eodes presented in 
Appendix A-1 in addition to the error codes presented below. Appendix 
A-1 and A-2 errors are reported by the Configurator in the format of 
"•ERROR XX", where XX is the two eharaeter decimal error code 
eorresponding to the error descriptions presented in Appendix A-1 and 
in the table below. 

CODE. ERROR MESSAGE 

44 s STATEMENT CANNOT BE CONFIGURED - STATEMENT LINE IGNORED 
^ 45 s SYNTAX ERROR IN CALL STATEMENT 

46 s CALL TABLE FULL - # OF DISTINCT SUBROUTINE CALLS EXCEEDS 16 
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APPENDIX A-3 
TX 990 OPEHATING SYSTEM EHRQR CODES 



The following error codes are reported by the TX990 Operating 
System. These errors are reported to the user as hexadecimal codes in 
the format of "FILE I/O ESHOR OXXH", where XX is the two character 
hexadecimal error code corresponding to the error descriptions 
presented below. 



Code 

(Hexadecimal) Description 

. .- ' . DSH EHBORS 

01 ILLEGAL LUNO 

02 ILLEGAL OPERATION 

03 LUNO IS NOT lET OPENED 

0^ RECORD LOST DUE TO POWER FAILURE 

05 ILLEGAL MEMORY ADDRESS 

OS TIME OUT, OR ABORT 

07 READ CHECK ERROR 

1 DEVICE ERROR 

2 NO ADDRESS MARK FOUND 
5 DATA CHECK ERROR 
9 DISKETTE NOT READY 
A WRITE PROTECT 
B EQUIPMENT CHECK ERROR 
C INVALID TRACK OR SECTOR 
D SEEK ERROR OR ID NOT FOUND 
E DELETED SECTOR DETECTED 

FILE MANAGEMENT ERRORS 

20 LUNO IS IN USE 

21 BAD DISC NAME 

22 PATHNAME HAS A SYNTAX ERROR 

23 ILLEGAL FUR OPCODE 

24 BAD PARAMETER IN PRE 

25 DISKETTE IS FULL 

26 DUPLICATE FILE NAME 

27 FILE NAME IS UNDEFINED 

28 ILLEGAL LUNO 

29 SYSTEM BUFFER AREA FULL 
2A SYSTEM CAN'T GET MEMORY . 
2B FILE MANAGEMENT ERROR 

2C CAN'T RELEASE. SYSTEM LUNO 

2D FILE IS PROTECTED 

2E ABNORMAL FUR TERMINATION 

2F FILE UTILITY DOES HOT EXIST IN SYSTEM 



,>ff*> 
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Code = 

(Hexadecimal) Description ! 

30 NON-EXISTENT RECORD 

3B INVALID ACCESS PRIVILEGE 

3E FILE CONTROL BLOCK ERROR 

3F FILE DIRECTORY FULL j 

TASK LOADER ERROR j 

60 I/O ERROR, LOAD NOT COMPLETE '' 

Si OBJECT MODULE CONTAINS KONRELOCATABLE OBJECT CODE 

62 CHECKSUM ERROR LOAD ABORTED 

63 , LOADER RAN OUT OF MEMROY 
S^ TASK 10 IS BUSY 

65 IMAGE FILE ERROR 

VDT ERRORS 

80 DEVICE NOT AVAILABLE 

VDT STATION NOT FOUND 

Note ; 

Error Code >FF is a general error code. 
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APPENDIX B 
POWER BASIC 
STAIESffiMT AND COMMAND SUMMARY 
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EDIT MODE COMMANDS 

Ai3.«advanced editor is eontained in POWER BASIC to aid in program 
writing, editing, and debugging. Note that no editing functions are 
supported in the '."Configured" or Target POWEB BASIC Interpreter. 
The special characters used to perform these editing functions are 
listed below for the 911VDT, and 913VDT terminal devices. Note that 
the phrase "(ctrl)" indicates the user holds down the control key 
while depressing the key corresponding to the character immediately 
following. Also note that FO, F1, F2 refer to the funtion keys in the 
top row of the 911 and 913 Video Display Terminals, 



■ 9nVDT 

RETUHN 

ENTER 

•"(Ctrl)" M 

ndown arrow) 
"(Ctrl)" J 



913VDT 
NEW LINE 
ndown arrow) 



EXAMPLE/EXPLANATION 

(CR) 

Enter last line typed 

into program source. 

(LF) 

Enter last line typed 
into program source and 
enable auto- line num- 
bering. 
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"(Ctrl)" In 
F2 


Fin 


(Ctrl) 14 
Insert n blanks. 


"(Ctrl)" Dn " 
F3 


F2n 


(etrl)D4 

Delete n characters. 


•"(Ctrl)" H 
"«»— (left arrow) 


'«— (left arrow) 


(etrl)H 

Backspace 1 character 


"(Ctrl)" F 
—•(right arrow) 


—•(right arrow) 


(ctrl)F 

Foward space 1 charac- 
ter. 


In "(Ctrl)" E 

In F1 


In FO 


100(ctrl)E 
Display source line 
indicated by line 
number (In) for 
editing. 


UNLABELED 
FUNCTION KEY 
"(Ctrl)" 2 


RESET 


•4.(ESC) 
Cancel input line or 
break program 
execution). 


DEL CHAR 
"(Ctrl)" _ 


DEL CHAR 


(DEL) 

Backspace and delete 

character. 
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gnvDT 


913VDT 
HOME 


EXAMPLE/EXPLANATION 


HOME 


HOME 






Position cursor at 






column 0, row 0. 


UNLABELED 

KEIPAD KEX 


CLKAH 


aSAB 

Clear screen and 
position cursor at 
coluian 0, row 0. 
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COMMANDS 

POWER BASIC commands direct and control system operations. Commands 
cause immediate computer interaction thereby allowing operator 
control. Commands may only be entered one per line and may not be 
entered into a BASIC program. For this reason a "configured" POWER 
BASIC application may contain no POWER BASIC commands. - 
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SIHTAX EXAMPLE/EXPLANATION 

CONtinue CONTHTOE 

Execution continues from last break. 



LIST [expj -(ex^ 



LOAD <$VAR> 



LIST 10-100 

Selectively lists the user's POWER' BASIC program. 

LOAD "DSCasPROCESS/CNT 

Reads a previously recorded POWER BASIC program from 
specified pathname. 
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NEW 



NEW 



Clear current user program, variables, pointers, 
and stacks , and prepares for entry of new program. 



NEW <addres^ NEW OAOOOH 



Sets the upper RAM memory bound used by POWER BASIC 
after auto-sizing at power-up. 



NUMBER [start-Un^ £, inc] 

NUMBER 200,20 



Specify starting line number and increment value 
for auto-line numbering. 
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SYNTAX EXAMPLE/EXPLANATION 

PURGE <start-line> TO <end-line> 

PURGE 200 TO 400 



Delete specified range of POWER BASIC statements 
from user program. 



RUN RUN 

Begin program execution at the lowest line number. 



SAVE <$7AR> SATE "CS1« 



Records a POWER BASIC program to the specified 
pathname. 



SIZE SIZE 



Display current program size, allocated variable 
space, and available memory in bytes. 



source SOURCE 



Display number of bytes that will be stored if 
the current program were SAVEd. 



STAck STACK 



Display the return line numbers'lfeich were pushed 
on the GOSUB stack. 



y/S^^V 
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STATEMENTS 

POWEB BASIC statements form the basis of all BASIC programs. 
Statements are typically entered into a program with line numbers and 
are executed when the HUN command is entered. Statements may also be 
entered in the keyboard mode without a line number and they will be 
executed ifflmediately. POWER BASIC statements may occupy only one 
line; however, numerous statements may appear on each line when 
delimited by a pair of colons (.it). All letters of BASIC statements 
must be entered in upper case. Not all POWER BASIC statements which 
execute on the Host POWER BASIC Interpreter may be "configured" into 
the Target POWER BASIC application. Any explanation preceded by an 
asterisk (*) indicates that the statement is supported by the Host 
POWER BASIC Interpreter, but cannot be included in a "configured" (or 
Target) POWER BASIC application. A "#" indicates that the statement 
. functions differently on the Host system then in a "configured" POWER 

'^ BASIC Target system. The user should reference the appropriate 

paragraphs of this manual for the detailed explanation on their 
operation. 

SYNTAX EXAMPLE/EXPLANATION 

In BAUD <exp1>,<;exp^ 

BAUD 0,5 

# Sets the baud rate of the serial I/O port(s) in the 
"configured" application. 

In BASE <{exp)> BASE (256) 
^ Sets CRU base for subsequent CRU operations. 

In BIE BIE 

* Terminates POWER BASIC and returns control to the 
TX990 operating system. 

In CALL <string-constant> , <subroutine address) Qvarl]][,var5[|,varf|{7varirj 

CALL "SUB1", ODEOOH,A,(B) 

^Transfers to assembly language subroutines. If 
variable is contained in parenthesis, then address 
will be passed; otherwise, the value will be passed. 
■•■• •' :. •-• Parameters are passed in H4, R5, R6, and R7. Retura • .• 

address is contained in R11. 



STWIAl EXAMPLE/EXPLANATION 



In DATA xstring-constantV , 



<exp> I 

Cstring-constant>j 



ysfcpv 



DATA 1, 4»ANT(1), "HI" 

Define internal data block for access by READ statement. 

InDEF FN<x>['«arsl2[,arg2][',arg3]5] =<exp> 

DEF FNA(X,I)=(3»X+I)/I 
- ■•- ' " Defines user arithmetic function. 

In DIGITS <exp> DIGITS 7 

* Specifies the number of digits to be output. 

In DIM <var (dimQdim] . . . )> Q . ... .]] 

DIM A(10), DOG(5,10,10) 

. Allocates user variable space for dimensioned or 
array variables. 

In ELSE <statement(s)> 

aSE GOTO 1000 

When most recently executed IF condition is false. ^ 
all subsequent ELSE statements are executed; 
oaierwise, the ELSE statement line is ignored. 

In END END. 

Teradnates program execution and returns to key- 
board code. 

la EQUATE <sim-var> , <^ar> Q<sim-var> , var] .... 

EQUATE MAM, A(0,5); 85,3(5) 

• * The specified simple variable is assigned the value 
of the second variable. 
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EXAMPLE/EXPLANATION 



In EBROR <ln> ERBOR 1000 



Specifies a subroutine that will be called via an 
internal GOSUB statement when an error occurs. 



In ESCAPE ESCAPE 

» Enables the escape key to interrupt program 
execution. 



In NOESC 



HOESC 
* (see NOESC statement) 



In FOR <sim-var>=<exp>,TO. <exp>[STEP <exp2 

FOR Isl TO 20 STEP 2 



The FOR statement is used with the NEXT statement to 
open and close a program loop. Both identify the 
same control variable. The FOR statement specifies 
the control variable and assigns the starting, 
ending, and optionally stepping values. 



In NEXT <^im-var> NEXT I 

(see NEXT statement) 



In qOSUB <pxi> GOSUB 2000 



Transfer program execution to an internal BASIC 
subroutine beginning at the specified line number. 



In POP 



POP 

(see POP statement) 
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S^TAX EXAMPLE/SXPLMATION 

In RETURN RETURN 

(see RETURN statement) 

In Gp70 <1a> . GOTO 300 



Transfer program execution to the specified line 
number. 



ln^n'._<3ondition> IHDI <statement(s)> 

IF IsO THEN I=J::GOT0 200 






Causes conditional execution of the statement(s) 
following THEN. Statements following THEN execute 
on TRUE condition. 



In ELSE <statement(s)> 

ELSE A2SQR(J)::G0T0 250 
(see ELSE statement) 

In IMASK <level> 

IKASK 8 

# Set interrupt mask of TMS 9900 Microprocessor on -^ 
target system to specified level. 

In.TPAP <leve^ TO <ln> 

TRAP 9 TO 1000 

# (see TRAP statement) 

In IRTtf IRTN 

# Return from BASIC Interrupt service routine. 
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SYNTAX EXAMPLE/EXPLANATION 

In INPOTKstring-var^' ]^, j Vstring-var:>/ 

INPUT 1, $B 

Places auaeric and string values entered from the 
keyboard into variables in the INPUT list. 

la [le5 ^^ * <exp>. 

LET AsB*4 

Evaliiates and assigns values to variables or array 
elements. The LET is optional. 

In N^XT <siffl-var^ 

NEXT I 

Delimits end of FOR loop. The sim-var must match 
the FOR control variable. 

In NOESC • ' NOESC 

* Disable the ESCape key, to disallow a program break. 



/goto^ 

^ In, ON <exp> THEN \gOSUB) <ln> Q liT] . 



ON I THEN GOTO 100,200,300 
ON J THEN GOSUB 500,600,700 

Case statement used to transfer program execution 
via a GOTO or GOSUB to the line number specified by 
the expression. 



In POP POP 



Removes from the GOSUB stack the last pushed 
return address without an execution transfer. 
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SYNTAX EXAMPLE/EXPLMATIOW 

In PRINT <exp> Qexp]], • « '' 

PRINT A,B,$NAM 



Print (without formatting) the evaluated expressions 
to the terminal device • 



In RANDOM <exp> RANDOM 4*MEM(0FD00H) 



Set the seed of the random-number generation to the 
evaluated expression. 



<nuia-var> ^ , 

In READ ^string ->var> ' 



<^num«var> 
<^string-var> 



READ A,$B,C(0),$D(0) 

Assigns values from the internal data list to 
variables or array elements. 

In REM text REM comment lines for documentation. Inserts 

comment lines into program • 

In RESTOR {ln\ RESTOR 

RESTOR 40 

RESTOR without a parameter resets pointer to begin- 
ning of DATA sequence, while RESTOR with a parameter 
resets pointer to specified line number.' 



In RESTOR # <ex^RESTOR #1 

RESTOR with a »•# exp " rewinds the logical unit 
number (LnNO) specified by the expression 

In RETURN RETURN 

Return from BASIC subroutine and remove top address 
from GOSUB stack. 



y^fiE>» 
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Smi&l EXAMPLE/EXPLANATION 

la SPOOL <exp1> TO <exp2> 

SPOOL 2 TO A 



* Directs unit output specified by exp1 to logical 
unit aufflber (LHNO) specified by exp2. 



la STOP STOP 



Tenniaate program execution and return to keyboard 
(edit) mode. 



la TIME <e3cp> , <^3cp> , ^xj5> 

TIME 1-1,24,30 



# Start the 24-hour time-of-day clock and set the time 
to the specified expression values. 



la TIME TIME 



.Output the clock time as HE:MN:SD to the terminal 
device. 



In TIME <;string-var> • 

TIME $A(0) 



Stores current clock time into specified string 
variable. 



In TRAP ^evel> TO <lfl> • 

TSAP 9 TO 1000 



# Assigns interrupt level to BASIC interrupt servicing 
subroutine. 



In UNIT <exi^ UNIT 3 



# Designate the device(s) to receive all printed 
output. 
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DISK FILE CONTROL STATEMENTS 

The following Host POWER BASIC Statements provide the capability for 
complete file support on the FS990 -system. None of these statements 
may be "configured" into a POWER BASIC application (target system). 

SYNTAX EXAMPLE/EXPLANATION 

<string variable> 
In BDEL <string eonstant> 

BDEL "DSCIsBASE/TST" 

* Deletes the specified diskette file. 

In BCLOSE <numeric variable> 

BCLOSE J 

* Closes specified file (LUNO). (Note that numeric 
variable is set by the BOPEN statement.) 

In RESET RESET 

•.Closes all files (LUNO's). 

In COPY <niaaeric ' variable> TO <numeric variable) 

COPY I to J 

* Copies contents of one file (LONO) to another. 

(<string variable^ 
<string constantV 

BDEFR •»DSC2:TEST/REL'' 

* Defines a relative record diskette file. 

/<strljQg variable)! 
In BDEFS Wstring constants^ 

BDEFS "DSC2:TEST/SEQ'* 
» Defines a sequential diskette file. 
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SSM EXAflPLE/EXPLAHATIQN 

I i 

<string varlable> . 
BQPEN <string eonstajnt> ^<nuffleric variable> 

BOPEN ''DSC2:FILE1/SYS",F1 

« Opeas specified file and assigns LUNO. 

In BINAHY 1:, <niaaeric variable> , <exp> 

BINAHlf 1,F,66j 2, A(0) 

• Sets BINAEI LUNO and specifies the number of bytes 
to be read or written by subsequent BINARY commands. 

In BSIAHI 2, <exp> ^exg ... 

BINARY 2, B(1) 

• Writes an assigned number of bytes from each 
expression to the BINARY LUNO. (The SH.'ARY LUNO and 
number of bytes are assigned by BINARY 1.) 

In BINARY 3, <numerie variable) [.-(numeric variable]^ ... 

BINARY 3 A,B,C 

* Enables the user to read an assigned number of bytes 
into each variable from the BINARY LUNO. (The 
BINARY LUNO and number of bytes are assigned bv 
BINARY 1.) * - 

In BINARY 4 , <exp1>.,.<exp2>, <expH> 

BINARY 4-, 6, 100, 

* Position within a random file to the specified given 
byte position. 
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FUNCTIONS 

POWER BASIC provides several predefined matheraatical, string, and 
system functions which simplify program entry and development. Any 
POWEH BASIC function may be used in any statement where a variable may 
be used, A function is called by using "function name (argument)", 
where the function name is the three»letter name and the argument 
maybe any expression or variable. The specified function of the 
ax^gument replaces the function name in the* statement in which it is 
used. Any explanation preceded by an asterisk (*) indicates that the 
function is supported by the Host POWER BASIC Interpreter, but cannot 
be included in a "configured" (or Target) POWER BASIC application. 



SYNTAX ^ 
ABS «exp>) 



EXAMPLE/EXPLANATION 

AsABS(B) 

Absolute value of expression 



y^S\^ 



ASC «string» BsASC($A) 



(see ASCII Character Conversion Function under 
STRINGS) 



ATN (<exp>) 



AsATN(l) 



Arctangent of expression, 
(expression in radians) 



BIT (<var>,<exp^>) 



AsBIT (B,I) 

Reads bit specified by expression within the 
specified variable. Returns a 1 if bit is set and 
a if not set. 



BIT ( <var> , <62cp 1> ) s <exp2> 

BIT (C,6)r1 



Modifies bit specified by expl in specified 
variable. Selected bit is set to 1 if assigned value 
(exp2) is non-zero and to zero if the assigned value 
(exp2) is zero. 
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SYNTAX EXAMPLE/EXPLANATION 

COS (<exp>) . AsCOS(B) 

Cosine of expression, 
(expression in radians) 



CRB «exp» AsCHB(-l) 



Reads CRU bit as selected by the CRU hardware base + 
exp. Exp is valid over range -127 thru 128. 



CRB «exp1>).s<exp2> 

CRB(.4}sO 



Set or reset CRU bit as selected by CRD hardware 
base + expl. If exp2 is non-zero, the bit will be 
be set, else reset. Expl is valid for -127 thru 128, 



CRF «exp1>) A=CRF(M) 

Read n CRU bits as selected by CRU base vrtiere exp 
evaluates to n. Exp is valid for thru 15. If 
expsO, 16 bits will be read. 

CRF «txp1>)s<^exp2> .^ 

CRF(5)sOFH 

Output expl bits of exp2 to CRU lines as selected 
C^ by CRU BASE. Expl is valid for thru 15. If 

expUO, 16 bits will be output. 

EXP,«exp>) A=EXP(B) 

Raise the constant e to the power of the 
expression. 

FRA «exp» . As FRA(B) 

^.■■- •■.. . * Return the fractional parf'of the expression. 
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SYNTAX EXAMPLE/EXPLANATION 

INP (<exp>) AsINP(B) 

Return the signal integer part of the expression. 

LEN (<string>) A=LEN($B(0)) 

(See String Length Function under STRINGS) 

LOG (<exp>). AsLOG(B) 

_ , . Return natural logarithm of the expression. 

MCH.(<string1>, <^tring 2>) 

MsMCH($A,$B(0)) 

(see Character Match Function under STRINGS) 



MEM «exp>) . AsMEM(OFFOOH) 

AsMEM( 65280) 

Read byte from user memory at address specified by 
exp. 



MEM (<exp1>)s' exp2 



MEM(OBOH)=OFH 
MEM(176)sT5 

Store byte exp2 into user memory at address specified 
by expl . 



NKI (<exp>) AsNKKQ) 

I? NK2:(65) THEN PRINT "A" 



Conditionally samples the keyboard in run- time mode. 
If expsO, return the decimal value of last key struck 
and clear key register. (^Zero is returned if no 
key was struck). If exp 0, compare last struck 
key with decimal value of exp. If they are the same, 
a value of 1 is returned and the key register is 
reset, if not equal then return a 0. 
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SYNTAX EXAMPLE/EXPLANATION 

HND Asm© 

Returns a random number between and 1. 

SGN «exp» . A=SGN(B) 

* He tunas s 

1 if expression is positive 

if expression is zero 

"1 if expression is negative 

SIN^ «exp>) . AsSIN(B) 

Sine of the expression (exp in radians). 

SQE «e3cp>.) .AsSQHCB) 

Square root of expression. 

SSH (^string1>,<^string2>) 

SsSHH($A,$B(0)) 

(See Character Search Function under STBINGS). 

SYS (<exp» AsSYS(2) 

Obtain system parameters generated during program 
execution. The exp values and corresponding system 
parameters are as follows: 

SYS(0)slnput control character 

SIS(l)sError code number 

SYS(2)sSrror line number 

TAN (<exp» .. AsTAN(B) 

» Tangent of expression (exp in radians). 
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SYNTAX EXAMPLE/EXPLANATION 

TIC «exp» TIsTIC (0) 

■■■ T2sTlC (T1) 



# Heturns the nuiabep of time TICs less the expression 
value. 



,^^ 
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STRINGS : 

I 

Strings variables in POWER BASIC are designated by preceding the 
variable name with a dollar sign ($). ASCII character strings are 
stored in contiguous memory byte locations with a null character 
terminating the string. Hence, simple string variables in POWER :BASIC 
which are 6 bytes in length, can contain up to 5 characters. Dimen- 
sioned string variables in POWER BASIC may contain up to the numtler of 
elements times 6, less one character. Also, dimensioned string 
variables may have a byte index following the subscript (s) to indicate 
a byte position within the specified string. This is indicat?'ed by 
following the subscripts with a semicolon and the byte displacement 
(e.g., $A(0;5)). 
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■ FtJNCTION/SYWTA X 

ASCII Character 
Conversion Function 
ASC (<string-var>) 



EXAMPLE/EXPLANATIOH 



ASC($A(0)) 



Convert first character of string to 
decissal ASCII Numeric representation. 



Assignment 
<string«>var>2 



l<string-variable>\ $A(0)s$B(0) 
\<(string«constant>/ $A(0 )s$B( 0; 5 ) 



Store string into string- variable 
ending string with a null. 



yiSSSsv 



Character Match Function 
MCH (<stringi;>,<String^) 



A=MCH("HI'',$B(0)) 

Return the number of characters to 
which the two strings agree. 



Character Search Function 
SRE (<string1>,<jstring2>) 



AsSRH ("BC", "ABCD") 

Return the position of stringi in 
string2. Zero is returned if not 
found. 
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FUNCTION/SYNTAX 



EXAMPLE/EXPLANATION 



Concatenate 
string-var 



(<string-variableX <string-var> 
<string-constant^ + <string-constant> 

$A(0)=$A(0)+''END'' 



L+ 



Concatenate specified string 
variables or string constants. 



Convert to ASCII 
<string-var>s exp 
<strijig'-var>s # string) , <^xpr> 



$N(0)sN 
$N(0)=#'»99,990.99'',TX 

Convert exp to ASCII character 
string ending with a null. "#String" 
specifies a formatted conversion. 
(See PRINT OPTIONS.) 



Convert to Binary 
<var1>s<string> , <var2> 



Ns"12'34"-,E 
Ns$A,£ 

Convert string into binary equiva- 
lent. Var2 receives the delimiting 
non-nuaeric character in the first 
byte. 



Deletion 
<string-va:^.s/^exp^ 



$A(0;3)s/2 

Delete exp characters from string 
var. 



,.<«*f^v 



Insertion 



K string-variableX 
<string-vai^ s/]^ string-cons tant>J.. 



■$A(0;3)s/"HI" 

Insert string into specified position 
in string variable. 
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FONCTION/SYNTAX EXAMPLE/EXPLANATION 



String Length Function 

. -^^tring-variableM LsLEN($A(0)) 
<nGffl-var>sLEN( Vst ring-cons tant>/) LsLEN "ABC" 



Return the length of string up to 
terminating null. 



Pick 

• /<string-variable^\ 
<string-var1>s j <string-constant2>/., <exi?> 

.^ ' ' $I=$A(0;2),3 

^^ $Js''ABCDE'' , 3 



Pick exp number of characters from 
sti^ng2 into string-varl ending 
string will null. 



Replace 

y<Cstring-variable2>*\ 
<string-vaf> s{ <string-constant2^|K^ ex;^> 



$B(0;2)s$A(0);l 
$3(012)3". ..'♦;2 

Replace exp number of characters of 
string-varl with string2. 
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INPUT OPTIONS 

The following options are available for use with the INPUT statement 
to provide the POWER BASIC user with enhanced terminal input 
capability. For additional details on their use, refer to the INPUT 
statement, Section 5, paragraph 5.8,1. 

SYNTAX EXAMPLE/EXPLANATION 

string-var INPUT $A 

Prompt with colon and input character data, 

, INPUT A,B 

Delimit expressions for multiple inputs 

; INPUT ;A 

INPUT A; 

Suppress prompting if before variable or suppress 
CH LF if at end. of lla&. 

#exp INPUT #1"T or »"$! 

Specify a maximum of exp characters to be entered. 

?exp BIPUT % 4"C0DE"C 

Requires entry of exactly exp number of characters. 

? la INPUT ?1005A 

Upon an invalid input or entry of a control charac- 
ter, a GOSUB is performed to the specified line 
number (In). SYSCO) will be equal to -1 if there 
was an invalid input. Otherwise, SYS(O) will equal 
the decimal equivalent of the control character. 



R-7"^ 



SYNTAX EXJiMPLE/EXPLANATION 



"STHING" INPUT "YES or NO?"|$A 



K<exp1>, <€xp2>) 



JS*»\ 



Prompt with string and then get input. Equivalent 

to? 

PRINT «IES or NO?" p : INPUT; $A 



INPUT € (10,20);A 

* Move cursor of video display terminal (VDT) to 
position specified by expl and exp2 before 
perfonning input variable assignment. 



(<string-constant>l 
<^string-variable>| 

INPUT §"C";A 



* Perform VDT screen commands as indicated under 
PRINT options o 



/f0^i\ 
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OUTPUT OPTIONS 

POWER BASIC provides the following options for use with the PRINT 
statement. They provide powerful print formatting capability for all 
user output directed to the terminal and/or auxiliary device (see UNIT 
statement). For additional information on these formatting options, 
refer to Section 5, paragraph 5.8.2.1 

S^fNTAX EXAMPLE/EXPLANATION 

; PRINT A|B 

PRINT A; 

Delimits expressions or suppress CR LF if at 
• ..._ ' . end of line. 

, PRINT A,B • ^^ 

Tab to next print field, 

TAB «exp>) PRINT TAB (50); A 

Tab to column specified by exp, 

string PRINT «HI";$A(0) 

Print string or string- var. 

* exp PRINT # 123 

Print exp as hexadecimal in free format. '*^ 

#, exp PRINTS, 50 

Print exp as hexadecimal in word format. 

*; exp PRINT #;A 

Print exp as hexadecimal in byte format. 
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SYNTAX 



<hex value> 



/!*fP*\ 



EXAMPLE/EXPLANATION 

PRINT •'<OD><pA>« 

Direct output of ASCII eodes. 

PHINT #"99. 00" 123 

Print under specified format v&ere: 

PRINT #"9999"! 
9 s digit holder 

PRINT •#"000-00-0000"SS 

s digit holder or force 

PRINT #"$$$$, $$$.00"DLH 

$ £ digit holder and floats $ 

PRINT #"SSS.0000"M*ATN1 

S s digit holder and floats sign 

PRINT.#"«<.00> "I 

<> s digit holder and float on negative 
number 

PRINT #"990,99E"N 

E s sign holder after decimal 

PRINT # "990.99"N 

. s decimal point specifier 
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SYNTAX EXAMPLE/5XPLANATI0K 



§ (<exp1>,<exp2>) 



PRINT #''990.00"N 

, s suppressed if before significant digit 

PRINT #"999,990 00"! 
= translates to decimal point 

PRINT- #"HI=99''I 

Any other character is prlnte<i. 

PRINT § (10-, 15) I "READY" 

» Move cursor of video display terminal (VDT) to 
position specified by expl and exp2 before 
performing specified output. 






S i^tring-constant^ 
vs tr ing- var iab le V 



PRINT @"C10D2R»;N 
* Perform VDT Screen commands as indicated: 

B s beginning of line 

C s clear screen ^ 

D s doxra 

H s home cursor 

L s left 

R s right 

Any integer proceeding these commands will repeat 
them specified number of times. 
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GENERAL INFORMATION 
SPECIAL CHARACTER 

Tfee following characters have a special meaning when encountered is 
prograsi statement lines : 

CHARACTER USE 

' . •* Statement separator when entering multiple 

statements per line. 

5 Tail remain indicator used for comments after 

program statement. 

» . Equivalent to "PRINT" statement 

ARITHMETIC OPERATIONS 



AsB 






Assigmient 


A-6 






Subtraction 


B+B, 


$A+$B 


Addition or string concatenation 


A«B 






Multiplication 


A/B 






Division 


A^ 






Exponentiation 


»A 






Unary Minus 


+A 






Unary Plus 


LOGICAL 


OPERATIONS 





The logical operators perform "bit-wise" operations on the operand(s). 
The operands are converted to 1 6-bit integer quantities before the 
operation, and the results of the operation are similarly 1 6-bit 
values. 

LNOT A I's complement of integer 

A LAND B Bit wise AND. 

A LOR B Bit wise OR. . • •- * 

A LXOR B' Bit wise exclusive OR. 



B-28 



RELATIONAL OPERATORS 

The relational operators are binary operators that operate on two 
arithmetic expressions. They return values of 1 (TRUE) or 
(FAL3E). 

AsB TRUE if equal, else FALSE. 

AssB TRUE if approximately eqxial (+1E-T), else 

FALSE ~ 

A<B TRUE if less than, else FALSE. 

A< sB TRUE if less than or equal, else FALSE, 

A>B .._ . TRUE if greater than, else FALSE. 

A>=B TRUE if greater than or equal, else FALSE. ^->> 

AOB raUE if not equal, else FALSE. 

BOOLEAN OPERATORS 

The boolean operators are designed to work on the resultant TRUE ( 1 ) 
or FALSE (0) conditions set by the relational operators. However they 
may also operate on variables within the program, in which case a zero 
value variable is- considered FALSE (0) and a non-zero value variable 
is considered to be TRUE (1). The boolean operators return value of 
1 (TRUE) or (FALSE). 

NOT A TRUE if zero, else FALSE 

A AND B TRUE if both non-zero, else FALSE. 

A Q^ B TRUE, if either non-zero, else FALSE. ^ 
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OPERATOR PRECEDENCE 



1. Expressions in parentheses 

2. Exponentiation and negation 

3. »,/ 

4. +, 

5. <s,<> 

6. >s,< 

8. ss,LXOR 

9. NOT,LNOT 

10. AND, LAND 

11. OR, LOR 

12. (s) ASSIGNMENT 



B-30 



APPENDIX C 

POWER BASIC ■ 

EXAMPLE' PBOGRAMS 



^"^^fX 
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C.I SINE WAVE 

. This sample program demonstrates the use of the TAB function. It will 
plot a sine wave given input from the user. 

LIST 

5 INPUT "HOW MANI CHAEACTERS PEH LINE ON YOUR TERMINAL? ;M 

10 INPUT '•MAGNITUDE''A|" PERIOD"!;" #STEPS"C 

15 PRINT 

20 FOR Isl TO C 

30 PRINT TAB(INP(M/2)+A*SIN(I/B))j."*" 

40 NEXT I 

.-'50 STOP 

HOW MANI CHARACTERS PER LINE ON YOUR TERMINAL? 80 
MAGNITITOE? 38 PERIOD? 3 STEPS? 30 

f 

» 

ft 

ft 

ft 

ft 
ft 

ft 
ft • 
ft 

ft 
ft 

ft 

STOP AT 50 



C-»2 



RUN 

HOW MAI CHAHACTERS PEH LINE ON YOUR TERMINAL ? 80 

MAGNITUDE? 30 PERIOD? 4 STEPS? 25 



* 
* 



STOP AT 50 



y;<Sfc^ 
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C«2 V.*QHD PUZZLE 

. This sample prongraa demonstrates eharacter array manipulation. It 
will hide up a twenty one user-seleeted words ia an array of random 
letters. 

100 DIM A(22,5),N(20,7),C(6) 

110 ^(0)=''ABCDEFGHIJKLMNOPQRSTUVWXrZ" 

1000 REM INIT ARRAr 

1010 FOR IsQ TO 22s s FOR Jsl TO 23 

1020 $A(I,0;J)s" " 

1030 NEXT Js: NEXT I 

1100 REM EI?TER DATA 

•" 1110 FOR NsO TO 20 

11*20 INPUT $N(N,0) 

^ 1130 IF $N(N,0)s'"« THEN GOTO 1150 

1140 NEXT N 

1150 NsN"1 !GET NUJffiER OF NAMES 

1200 REM FIT INTO ARRAX 

1210 FOR IsO TO N 

1220 TRIsO ! NUMBER OF TRYS 

1230 TRYrTRX+l 

1240 IF TRI-INP(TRY/100)» 100=0 THEN PRINT TRY"TH TRY TO FIT "$N(I,0) 

1250 IF TRY>500 THEN GOTO 1210 'START AGAIN 

1260 RsINP(RND»22);: RIsH 

1270 CsINP(RND«22)+1:s C1sC 

1280 MsINP(RND*8)+1 • 

1290 IF M=1 THEN RR=-1m CCsO 

1300 IF M£2 THEN RRs-1:: CCsl 

1310 IF M=3 THEN RR=0:j CCsl 

1320 IF Ms 4 THEN RRs1::CCs1 

1330 IF M=5 THEN RRsI;: CCsO 

^^ 1340 IF M=6 THEN RRsIs: CCs-1 

■ 1350 IF Ms7 THEN RRsOs; CCs-l 

1360 IF M=8 THEN RRs-1 ; ; CCs-1 

1370 FOR Jsl TO 19 

1380 IF $N(I,0;J)s"" THEN GOTO 1500 

1400 IF " ••s$A(R,0;C),1 THEN GOTO 1430 

1420 IF $N(I,0;JK>$A(R,0;C),1 THEN GOTO 1230 !FIT FAILED, TRY AGAII 

1430 RsR+RR:; C=C+CC 'MOVE TO NEXT 

1432 IF R>-1 THEN IF R<23 THEN IF C>0 THEN IF C<S4 THEN GOTO 1440 

1436 IF $N(I,0;J+1K>'"' THEN GOTO 1230 

1440 NEXT J 

1500 N(I,5)sR1j; N(I,6)sC1s: N(I,7)sM ! SUCCESS !! SAVE POSITION 

1510 FOR Ksl TO J-1 !D0 ACTUAL MOVE 

• •■ 1520 $A(R1,0jC1)=$N(I,0;K)5l:; RIsRURR:: CIsCUCC • 

1530 ■ NEXT K 

1540 • NEXT I 
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1550 INPUT "DO rOU WANT TO SEE THE ANS^^ERS?"$1;$I 

1560 IF $Is«'Y" THEN GOSUB 2000:: G0SU3 3000 

1800 REM FILL IN PUZZLE 

1810 FOR IsO TO 22:: FOR J=1 TO 23 

1820 $L=$A(I,0;J),1 

1830 IF " "=$A(I,0;J),1 THEN $A(I,0; J)=$C(0;INP(RND*26)+1); 1 

1840 NEXT J:: NEXT I ' 

1850 GOSUB 2000 

1860 STOP 

2000 REM PRINT ARRAY 

2005 PRINT :: PRINT 

2010 FOR 1=1 TO 49:: PRINT "*";:: NEXT I:: PRINT 

2020 FOR IsO TO 22:: PRINT "• ";:: FOR Jsl TO 23 

2030 $Ls$A(I,0jJ),1:: PRINT $L" "; 

2040 NEXT J:: PRINT "»":: NEXT I 

2'050 FOR Isl TO 49:: PRINT «*";:: NEXT I:: PRINT 

2060 RETURN 

3000 FOR IsO TO N '^ 

3010 PRINT $N(I,0) TAB 20;N(I,5)+1 ;N(I,6) ;N(I,7) 
3020 NEXT I 
3030 RETURN 

RUN " • . 

POWER BASIC 
TEXAS INSTRUMENTS 
COMPUTER 
MICROPROCESSOR 
TERMINAL 
CASSETTE 
DIGITAL 
RAM 
EPROM 

DO lOU WANT TO SEE THE ANSWERS?! 
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TEXAS INSTRUMENTS 


7 15 5 








COMPUTER 
MICROPROCES: 


30R 


16 16 2 
21 3 1 








TERMINAL . 




9 6 5 








CASSETTE 




19 13 7 








DIGITAL 




7 2 3 








RAM 




11 10 3 








EPROM 




4 18 5 
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»LAQ7HWF 


E R 


D F 


S 


R U Y V V X Y 


H 


S V A » 


» C G D E M 


R r U Y 


K U 


I 


EBITQEOQS 


E D Z » 


» X R E R T 


L I 


A B 


J 


R 


V T P A M E K 


C 


D H * 


» B P H I S 


H F 


N G 


J G 


F 


D I M X P D 


a 


H K F * 


* R G n P E 


H I 


U S 


L P 





WYCJVRUVQWL* 


» D I G I 


T A 


L U 


D I 


E 


J J T J B Q 


c 


P Q Y * 


* C Z R E D 


P C 


C J 


F R 


P 


D Y S R M M D 


N 


C A I » 


» r S R C 


T I 


D E 


D A 


C 


N J X Q R Y Y 


B 


E X R * 


« H.I.SDE 


E C 


W B 


I S 


H 


H V A T A K Y 


a 


S E J * 


» F S A M 


R K 


A B 


R A 


M 


X K S M M A 


B 


Til* 


» J J E I X 


M S 


W H 


N G 


C 


X B N- X M M D 


a 


L P N » 


» T A C A C 


I H 


G a 


Y 


B 


G H I D M X P 


B 


N X » 


» W A Y C 


N G 


Y V 


M I 


S 


I N H A M G 


p 


Y T M » 


» E I R E E 


A E 


T 7 


T R 


T 


I Y S A D U 


p 


X Y J * 


» Y C P M N 


L K 


T H 


B P 


G 


E Y T C L D E 


K 


F I » 


» X F X X 


F E 


F A 


G'A 


XYIRXUZX 


G 


A Q S » 


» S Y R S S 


G E 


I E 


B 


S 


M U S K P F 


L 


G H F » 


»YGCXQET 


T E 


S S 


A 


C M T V X J 


G 


X R S * 


* ? A I X G 


a M 


S V 


D T 





F E C T T 


X 


G C W » 


» Z F M J W 


I J 


T F 


Q L 





T X JT I K K 


E 


E X * 


* L Z H C T 


D P 


B C 


H V 


R 


P G T G K R F 


M 


Z A L » 


* G J Q Q W L 


P Y 


W D 


LSFSGOTU 


T N B X » 


»«»»»»»»*»»«««««««»«»»««»#i,»»»##,«»#»,»»,HHf,5j^j,, 


STOP AT 1860 
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APPENDIX D • 
FLOATING POINT PACKAGE 



D-1 



D. 1 INHODUCTION 

. This appendix eentains the docuaentation of the floa'ting point 
package. The package may be accessed by an assenbly language program 
through the use of XOPs. 

The POWEH BASIC Floating Point package is a single accumulator 
Floating Point Processor. It includes the common operations of 
addition, subtraction, multiplication and division. Also provided are 
utilities to load, store, scale, normalize, clear, float and negate. 

D.2 SYNTAX 

XOP SYNTAX I 

LABEL y..XOPX.. GA,OPy.. conanent 
For clarity in explanation, the XOPS will be defined as follows: 



DXOP 


LOADF,0 


DXOP 


STORE, 1 


DXOP 


FADD,2 


DXOP 


FSUB,3 


DXOP 


nTO.,M 


DXOP 


FDIV,5 


DXOP 


SCALE, 6 


DXOP 


NORMAL,? 


DXOP 


aEAR,8 


DXOP 


NEGATE, 9 


DXOP 


FLOAT, 10 



^ D.3 . FLOATING POINT FORMAT AND ACCURACY 

Detailed information on the format and accuracy of floating point 
numbers may be found in Section 3.7.7. 

D.4 ' Paragraphs D.li.1 through D.4.7 describe the utilities provided by the 
floating point package. 

D.4.1 LOAD 

XOP (LOAD) will load FPAC (Floating Point Accumulator) with the 6 
byte number addressed by the operand. 
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Example : 

LOADF SFP1 or XOP SFP1,0 

e 

a 
« 

FP1 DATA >4110,>0000,>0000 
Will load FPAC with the contents of FPl. 



D.4.2 STORE 



XOP 1 (STORE) will store FPAC at the 6 byte location addressed by the 
operand* . 

Example: 

STORE @FP2 or XOP §FP2,1 



FP2 BSS 6 
Will transfer the contents of FPAC to FP2. 



D.4,3 SCALE 



XOP 6 (SCALE) will adjust the exponent of FPAC to the value of the 
operand. 

Example : 

SCALE §C4A or XOP gC4A,6 



C4A DATA >4A00 

Will adjust FPAC so the exponent becomes >4A. 

The SCALE XOP may also be used to convert a floating point value in 
FPAC to an integer value in FPAC. Mote the user should verify that 
the exponent of the floating point value is not larger than hex 44, 
otherwise the floating point number is to large and cannot be 
represented as an integer. The integer format of POWER BASIC is 
presented in Section 3, Paragrph 3.7.7. 
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The SCALE XOP with an operand value of hex 4600 will convert the value 
in FPAC to an integer number as follows; 

SCALE i CHeoO or XOP € C4600, 6 



C4600 DATA >4600 

D.l».4 NORMALIZE 

XOP 7„ (NORMALIZE) will adjust FPAC sueh that the first hex digit of 
'" the fraction is non-zero. 

Example: 

NORMAL or XOP 0,7 

Will normalize FPAC. 

Ncte that the operand has no significance. 

D.4.5 CLEAR 

XOP 8 (CLEAR) will zero FPAC- 

Example: 

CLEAR or XOP 0,8 

(^ Will zero FPAC. 

Note that the operand has no significance. 

D.tt.6 NEGATE 

XOP 9 (NEGATE) will negate FPAC by changing the first bit. If FPAC is 
zero, it will remain zei?o. 



NEGATE or XOP 0.9 
Will Negate FPAC. 
Note that the operand has no significance. 



D-4 



D.4.7 FLOAT 

. XOP 10 (FLOAT) will float the second ward of FPAC into a floating 
point number. This word is a 16 bit 2's compliaent integer. 

Example : 

an RO 

LI R1,100 

CLR R2 

LOADF RO OR XOP 0,0 . 

FLOAT OR XOP 0,10 

STORE §FP100 OR XOP §FP100,1 

* "♦" e 

FP100 BSS 6 • '^^ 

Will load FPAC with a decimal 100, convert it to floating point and • 
store it in FP100 . ^ y <^ 

Note that the operand has no significance, 

D,5 Paragraphs D.5.1 through D.5.5 describe the mathematical operators of 

the floating point package. All operators are required to be 
normalized and the result will be normalized and returned in the 
floating point accumulator (FPAC). If the result is zero, it is 
returned as a true zejro (i.e. all zeros as ooposed to a floating ooint 
zero, >4000, >0000, >0000). 

D,5-.1 XOP 2 (ADDITION) will add the 6 byte number addressed by the operand 
to the FPAC and place the results in FPAC. 



Example; 

FADD §C10 OR XOP gC10,2 

CIO DATA >41A0, >0000, >0000 
Will add the contents of CIO to FPAC and place the results in FPAC. 



D.5.2 SUBTRACTION 



XOP 3 (SUBTRACTION) will subtract 6 byte number addressed by the 
operand from the FPAC and place the results in FPAC. 
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FSOB §C10 OR XOP §C10,3 



CIO DATA >U%kO, >0000, >0000 
Will si2brtraet the contents of CIO from FPAC and place the results in 

D.5.3 HJLnPLlCATION 

^ XOP k (MULTIPLICATION) will multiply FPAC by the 6 byte number 

addressed by the operand and place the result in FPAC. 

S3£ample t 

FMUL iCIO OH XP §C10,4 



CIO DATA >41A0, >0000,.^0000 

Will multiply the contents of FPAC by the contents of CIO and place 
the results in FPAC. 

D.S.i* DIVISION 

XOP 5 (DIVISION) will divide FPAC by the 6 byte number addressed by 
f^ the operand and place the result in FPAC. 

Example : 

FDIV €C10 OR XOP gC10,5 



CIO DATA >41A0, X)000, 3»0000 

Will divide the contents of FPAC by the contents of CIO and place the 
results in FPAC. 
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D.5.5 


EXAMPLE 










For example, the 


equation 




* 


A=B+C«D 
Would become: 


1 








LOADF 


§C 


OR 


XOP gc,o 




FMDL 


ID 


OR 


XOP @D,4 




FADD 


§B 


OR 


XOP §B,2 




STORE 

« 


€A 


OR 


XOP |A,1 




• 

A BSS 


6 








B DATA 
C DATA 
D DATA 


>4110, >0000,>0000 
>4118, >0000, >0000 
>4118, ^OOOO, '^0000 



/rfltffW 



jr-^lfff^v 
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APPENDIX E 
CONFIGDHATOR EXAMPLES 

The following examples demonstrate the configuration process for two 
simple example programs. The complete execution sequence will be 
presented as well as the listings produced by the Configurator and the 
Link Editor. The configuration process will culminate in execution of 
the configured example program. 

E.I CONFIGURATION OF SINE WAVE EXAMPLE PROGRAM 

^ The sine wave program presented below will plot a sine wave given 
input from the user. This program' will be developed and thoroughly 
tested on the Host POWER BASIC Interpreter before continuing to the 
configuration process presented below. The listing of the program is: 

LIST 

5 REM TEST 4 

7 BAUD 0,4. 

10 INPUT "HOW MANY CHARACTERS PER LINE ON lOUR TERMINAL?" ;y. 

20 INPUT "MAGNITUDE "A;" PERIOD "B;" # STEPS "C 

30 PRINT 

40 FOR Isl TO C 

50 PRINT TAB (INP(M/2")+A*SIN(I/3)): "«" 
60 NEXT I 
70 STOP 

The user will then save the program onto a diskette file as follows; 

^ BDEFS "DSC2:TEST4/SRC" 

SATE "DSC2:TEST4/SRC" 

The diskette files to receive the Configurator outputs must also be 
defined as follows: 

BDEFS "DSC2:TEST4/LNK'' 
BDEFS "DSC2:TEST4/0BJ" 

The user will then terminate the Host POWER BASIC Interpreter (via the 
BIE statement) and return to the TX990 Operating System. 

Next the Configurator will be executed. For details on the loading 
and execution of the Configurator, refer to Section 2. The user 
will respond. to the prompts of the Configurator as follows: 






will respond to the prompts of the Configurator as follows: 

POWER BASIC CONFIGURATOR REV C.I. 4 

APPLICATION SRCEs DSC2:TEST4/SRC 
LINK CONTROLS DSC2: TEST4/LNK 
OBJECT FILEs DSC2:TEST4/0BJ 
LIST FILEs LP 

The Configurator will begin executing on the application program and 
produce., the link control file, object file, and the listing output. 
When "the configuration process is complete, the APPLICATION SRCEs 
prompt will again be displayed.- The user will respond with the ESCAPE 
key (RESET on the VDT913 or unlabeled function key on the TOT911) to 
terminate Configurator execution. 

The listing output produced by the Configurator is shown in Figure 
E-1. The user should refer to Section 3, paragraph 8.4.3.3 for 
details on the Configurator list file output. 

The Link Editor will then be loaded and executed using the TXDS 
Control Program. The user responses to these prompts are as follows: 

T3QS 936215 *A 293/78 11:25 

PROGRAM : DSC : TXSLNK/SYS 

INPUT: DSC2tTEST4/LNK 

OUTPUT: DSC2:TESTVSYS,LP 

OPTIONS: Ml 5000 

The Link Editor will be called into execution, and will produce the 
final linked Target POWER BASIC Interpreter/Application. 

The listing output produced by the Link Editor is shown in Figure E-2. 

The user may then test the final object module (DSC2:TEST4/SYS) by 
using AMPL to verify the operation of the Target POWER BASIC 
Interpreter/Application before performing the final step of 
programming the object file into EPROM. 
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POWER BASIC CONFIGURATOR REV C.1.4 



MOLiUL.K SUMMAKY 
Mi:im.iLES i.l!t:F.D 





PRIMARY 


SECONDARY 


NAME 


REF 


RfcF 


BiAUDC 


1 


6 


CVDB 





2 


FOR 


2 





OOSIJB 





2 


IPCOM 





4 


MOVE 





4 


PRINTC 


2 


• 


SINF 


3 








PRIMARY 


SHCONDi 


NAME 


REF 


REF 




— .— 


«.__ 


CVBDC 





2 


CVGC 





4 


FUNCC 


1 





INPUT 


2 ■ 


C» 


JMP 





4 


POLY 





• 1 


PUlB 





2 



POWER BASIC CONF I CURATOR REV C, 1.4 

STATEMENTS USED 



NAME 

FOR 

NKXT 

PRINT 

INPUT 

BAl..i):i 



# OF REFS 






MODULES 

FDR 

FOR 

PRINTC 

INPUT 

BAUPC 



POWER BASIC CONFIGURATOR REV C.1.4 

Af ••PL .1 C:AT I ON ?:0l. IRCE«DSC2 J TEST 4/ SRC 

L I NK CON TR0L=DSC2 : TEST4 / LNK 

OBJECT FILEaDSC2:TEST4/0BJ 

( ElUT ERRORS. IF ANY» LISTED HERE ) 



NUMBER (;iF BYTES CiF PSFUDO SOURCE* :>OOCC 



POWER BASIC CONFIGURATOR REV C,3.4 

FUNCTIONS USED 
NAME # OF REFS MODULES 



INP 
SIN 



FUNCC 
SINF 



FIGURE E-1. CONFIGURATOR LIST FILE OUTPUT 
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TXSLNK ^•Ul 78.2aa Ol/oo/cn 00207:0" PAG? I 

CU^^^'ANO LIST 

NCAUTO 

TASK CHAsic -; 

ISCLUOC sSTA«^TC/OHJ 

IMCLUOF fnAijirC) 

INCLI«0E (CVdnc) 
TNCLUOE (CVO«^)* 
1.>4CLI»0F (CVGC) 

itMCLuoe (fo^) 

INCLUOF (FltNCC) 

INCLUDE (C-nsnt) 

INCLUDE CUo'PUT) 

T«'VCLUOE fIPCON») 

INCLUDE CJ^^P) 

INCLUDE (f-^OvF) 

I^eCLUDF fPOLt) 

•INCLUDE CPffUiTC) 

INCLUDE (PUT«^) 

INCLUDE C-SINF) 

INCLUDE (ZZEWOC) 

INCLUDE 0SC2:TESTa/08J 
END 

SY^fiOL MULTIPLY DEFINED *t\^«A*'^'*w*>'i«,ii*ft*>^«w'«V»'»v^*r. •t^^w-tw^y. ♦.>«»^'»r*vv*-'^**^r*/i*,ii*ini 
SYMeOL s AF.SF mqouLES s 7/ 17 

SYMBCL ^^ULTIPLY DEFINED ♦w*v<i«»%*v^*,<*V\*«*v*vN«i'.*rt*i^»A*w«i«*w»iT*.^«'^*'.\*v»«*^«t>#vif«i%#w 
SYMBOL = »AU0 MODULES s 2, 17 

SY^J^CL *^tJLTIPLY C£F INEO tw*w*fi*r«*w*.4*VN«y;*»'!{#i^«rJ*K**^'«v*<'»t*.*'.**?r'»;'j«'»»*v5*:n»*s*r«*,»*^ 
SYMQOL s- CQSF MODULES s lo, 17 

SYMQO^ MULTIPLY DtFl^ED *^1^V'<♦t^*V^»w«»^«*^«^^*\v«yl»*^*^«r^♦^»•♦VS'*i•.♦A♦;i*!^♦W♦<«l*•.>*•'f *^i*v* 
SYMBOL s CVHO MODULES = 3r 17 

SYMBOL MULTIPLY DEFINED ♦l^*ii«*tnt^«i»i#<y«w«i**k*wi««»*W*t^*if;»v ♦,».*,%'#v«*v##^*%«t*/i*rt ♦-!*#» 
SY»«BOL s CV8T MODULES s 3. 17 

SYMBOL MULTIPLY DEFINED ♦»i*w*w*h*rt«»%»**i»^*w#w*n*w#vi«^'»v^«»»*«3!j*»^*w*:t*.i«-t««*«*f^» 
SYMBOL s FORY MODULES s 6# 17 

Symbol multiply defined ♦«»♦1<*W♦»v•jp•*•«*w#t^♦W«n*^^»•¥«•i1♦w•W•¥1*<^♦w*w«rt♦•.1*^••*W^^v*1^•^ 
SYMBOL s GOSl MODULES s 8# 17 

SYMBOL MULTIPLY DEFINED ♦i^*f^#/r*i^*v?*w*w«»i**w*ix*f%*n*vii«»<»*W«Airw*vt*«i*w*i^«v<*AJ*w*w 
SYMbOL s GOSfll MODULES s fl, 17 

SYMBOL MULTIPLY DEFINED «i»*w«/i*vt*'^*V^*W«i^i»W*w#i%*v^«W*ifii*4'»Hi*/i*w«»ir,*rt*.>*w«ii^*,t*tv 
SYMBOL s GHSY MODULES s ft, 17 

SY»*flOL MULTIPLY DEFINED ♦w«w*i^«;v»«v*.t*w*i^*w*iN#w*^***«V'»*w*«^*i«**^«»i««*s>«.i*%tr*i<#^r 
SYMBOL s GPTY MODULES s «/ 17 

SYMBOL MULTIPLY DEFINED *ff«*¥«v¥#«*%«i#w«f<*%ii*w*v^*<(^*(«*W*i**W'^'.^*W*»<*K*w*>i* 
SYMBOL s INPF MODULES s 7, 17 

StMBDL multiply DEFINED ♦y»*vii*vi"tw«*ti*w*w*w«i«*i^*««lro*w«if'*w*-#*v»*iii«W'«tt«vfti««(,*w#»ii#w 



FIGOEE E-2. LINK EDITOR LIST FILE OUTPUT (SHEET 1 of 4) 
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.TXSLNK 2.3.1 78.244 Ol/OO/UO o6!l^sS2 
COMMAND LIST 

SYMBCU. s IMPY MODULES s 9, 37 

SYMBOL MUniPLY DEFINED «W*W*W«W*W*W*W*W*W*W*W*W*W«W*W*W«W« 
SYMBOL s NKYF MODULES « 2, 17 I 

SYMBOL MULTIPLY DEFINED *W*W*W*W*W*W*W*W*W*W*W«W*W»W*W*W»W* 
SYMBOL « NXTY MODULES = 6, 17 ' 

SYMBOL MULTIPLY DEFINED «W*W*W*W*W*W-»W*W*W*W«W*W*W*W»W*W«W* 
SYMBOL » PQPY MODULES » S, 17 

SYMBOL MULTIPLY DEFINED *W*W*W*W*W*W*W*W*W*W*W*W*W«W*W»W«W« 
(^ SYMBOL » PR TY MODULES * 14, 17 

. SYMBOL MULTIPLY DEFINED *W*W*W*W*W«W«W*U*W*W*W*W«W*W«W*W*W4t 
SYMBOL « RTNY MODULES « S, 17 

SYMBOL MULTIPLY DEFINED *W*W*W*W-HW*W-KW*W*W*W*W*W*W«W-ag*W«W« 
SYMBOL « SXNF MODULES s I6, 17 

SYMBOL MULTIPLY DEFINED «W*W*W«W*W*W*W»W*W*W*W*W*W*W*W«W*W* 
SYMBOL « SYSF MQUULKS - V ■, 17 



• r X SLNK 2 . ?M 7:=! . :>44 01/ 00 / 0(5 00 s 1 •?- s 52 
LINK MAP 






CONTROL FILE « DSC2: TES'i 4/LNI':; 

LINKED OUTPUT FtLE = DSC'2J •rEST4/SYS 

LIST FILE « IP ^ 

0«.jr PUT FORMAT = ASCII 

I..1BRARIES 

NO ORGANIZATION PATHNAME 

t SF.QUENriAL sCBASIC/LIB 



FIGCHE E-2. LINK EDITOR LIST FILE OUTPUT (SHEET 2 OF 4) f 
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TtSLN< 



2*3.l 7H.?aa 



oi/no/00 Ofl:07:o<i 



^AGf: 



PHASE n. 


CB4.SIC 


flRIGIN 


s 1)000 


U£:^GTH s IO30 








MOOUUc 


NO 


UPIGIN 


tei'jGTH 


TYPF 


DATF 


Tl«t 


C-!EATO« 


STihTC 


t 


0000 


OHOa 


INCLUDE 


0!/02/7« 


!^:<i»svj 


SDSL^.'K 


aAuoc 


2 


OaOo 


0138 


INCLUDE,! 


01/03/79 


09:'3l;17 


.«0?Lr.,N 


cveoc 


1 


0C3C 


03aE 


, INCLUDE,! 


01/03/79 


09:52:52 


SO.^L'-K 


CVD8 


a 


OFAA 


01P2 


IMCLL'OE,! 


01/03/79 


09:52:51 


SUSLMi. 


CVRC 


•i 


113C 


005E 


INCLUDE,! 


Ol/03/7« 


09:53:0tt 


SOSL'JK 


FUR 


b 


119A 


01fl2 


INCLUDE,! 


01/03/79 


09:5a:i2 


SOSLMK 


FvlNCC 


7 


lilC 


005ft 


INCLUDE,! 


01/0 3/79 


A9:5a:3! 


SOSLNK 


60SU6 


..* 


127-2 


«QA^ 


.INCLUDE, 1. 


01703/79. . 


. 09j55.:0fl.- 


SOSLNR 


INPUT 


<»■ 


iai2 


oioa 


INCLUDE,! 


01/03/79 


09:55s39 


SOSLMK 


TPCOy 


10 


Iblo 


003A 


INCLUDE,! 


0!/0-3/7« 


09:56:08 


SOSLNK 


JMP 


U 


1550 


,00 1 c 


INCLUDE,! 


01/03/79 


09:59:2! 


SOSLNK 


MOVE 


12 


156C 


00<S0 


INCLUDE,!. 


01/03/70 


09:57:27 


SOSLNR . 


POUY • 


• li 


, ISCC 


006A 


IfiCLUOe,!' 


01/03/79 


09:57:5! 


SOSLNK 


PRINTC 


Itt • • 


t63d 


0t3« 


INCLUDE,! 


01/03/79 


, 09;5«:21 


SOSLNK 


•?VT8. 


.15. 


t.7.A6 


O.OaE 


IMCLUOe,!- 


01/03/79 


.09^58:02 


.SOSLNK 


•SINF 


t6 


X7B6 


00 io 


INCLUDE,! 


01/03/79 


09:59:50 


SOSLNK 


ZZEWC 


17 


tS^ft 


oooe 


INCLUDE,! 


01/03/7O 


10:01:02 


SOSLNK 


«00T 


IM 


l^bU 


oocc 


INCLUDE 






CONFIG 



./"BJIN 











E F- 1 


[ N 1 T I N 


3 










NAMg 


VAui.'E 


MO 


^AME 


VAI.IJE .' 


JO NAME 


VALUE 


NO 


NAME 


VAUDE 


Nn 


AflSF 


1356 




AOOF 


09Ra 1 


I 4N0F' 


1856 


17 


ASCF 


!''56 


17 


ASRO 


003C* 




ASS! 


003£« 1 


ATNF 


1356 


17 


f-Ol 


09M 




b05 


0«fe5 




520 


•OlFE 1 


I ■ B3F 


OlFF 




KASY 


1*56 


17 


BAUD 


0PO« 




• BCR'J 


0034* 1 


I blTF 


1856 


17 


• filTY 


1856 


!7 


9MVE 


156C 


12 


8US 


OOOC* 1 


*C1 


0«60 




ca 


0962 




CaAOO 


OlFC 




*C6 


096A 1 


I CCNT 


O02'»« 




•CKEX 


0536 




•CLKAOP 


FEftC* 




CLKT 


, 19SA 1 


17 ♦CLKTOl 


FE72* 




•CLKTO? 


FE7a* 




HILKWS 


FEbA* 




CLLY 


!<<56 ] 


L7 cnsF 


1766 


16 


CRttF 


1856 


17 


C98Y 


lfl5«' 


17 


CRFF 


l«56 1 


[7 CRFY 


1A56 


17 


CVBO 


0C48 




*CV8F 


OEae 




CV8I 


ocao : 


5 CVCIO 


1 16a 




CVCH 


FEEC* 




•CV0820 


loca 




CVOIFZ 


0F8E i 


1 «CVOIZ 


OF»A 


u 


CVGCN 


113C 




CV6CN1 


liaa 




CVhO 


FEF2« 1 


[ CVHOOl 


FFF3* 




CVhOl5 


FFOl* 




•0ATX8 


0201 




♦ ODM 


0022* 1 


OFFY 


1856 


17 


01 MY 


1856 


17 


• DLC 


0020* 




OLIM 


001F« 1 


I OS 


FF76* 




OS! 


FE7C* 




•032 


FFec« 




• 0S3 


FFC2* 1 


I *E5P 


FEF2« 




«EFLG 


002A* 




ELNM 


002E* 




«£LSF 


0030* ] 


I 'ELSY 


1856 


17 


ENUM 


002C» 




ERRY 


!?56 


17 


EUS 


0002* ] 


• EVAL 


073C 




•EVALS2 


073a 




EVARZ 


0582 




EVERZ 


05CC 1 


L «£VFX 


05Ea 




•feV0P3A 


087E 




EVSOZ 


057tt 




EVSFR 


07ia ] 


I *£VSKH 


FEF2* 




♦EVSKE 


FF9tt« 




EXPF 


1856 


17 


• FAO 


0246 ] 


I FAOOI 


OSIE 




•FCLR 


oaaE 




•FOD 


Oa82 




FFLG 


0032* 1 


I FIX 


0A82 




*FLDO 


023a 




•FLOAT 


0300 




♦F»«0 


0362 ] 


L *FN£6 • 


02F6 




•FNRM 


0328 




FNS 


000a« 




•FNSZ . 


OOOA* 1 


•F0R2 


llOA 


6 


FOHY 


119A 




FPAC 


FF9C* 




PPAC2 


FF9E* 1 


I FPACa 


FFAO* 




tfPYtP 


FF9C* 




•FSCL 


0S«6 




•FSO 


023C ] 


I •FSHO 


022C 




FSU8I 


0532 




FUN8K 


iscc 


13 


FUNFX 


ISFS 1 


1 3 •FUZZ 


3800* 




• GETC 


OAFS 


2 


SETCR 


OPEC 


2 


GOSl 


1386 ! 


I •60S2 


1332 


8 


60S8! 


1372 


8 



/<«!!Sx 



FIGURE E-2. LINK EDIT FILE OUTPUT (SHEET 3 OF 4) 
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/f^^ 



TXSLNK 




2c3. 


i 7a.2«<j 




01/00/00 00s 


07 s 04 






PACE 


5 


NAME 


VALUE 


NO 


NAI*f- 


VALUE 


NO 


NAME • 


VALUE 


NO 


NAME 


VALUE ) 


hO 


*€OSON 


1362 


8 


60SY 


1380 


8 


SOTY 


13S2 


6 


esc 


0016« 




• 6S2M 


12PA 


6 


ess 


0006* 


1 


•6SS2 . 


0014* 


1 


HFLS 


0034* 




»«OUT 


172C 


10 


IFLC 


0036* 


1 


IFY 


1856 


17 


IMKY 


1856 


17 


IMPEND 


152C 


10 


l»fPF 


133A 


7 


INPY 


1«12 


9 


•INTFLS 


FE56« 




INTIN 


185* 


17 


••1NTS6 


FE36« 


1 


»INTSP 


FE58« 


1 


• INTV»P2 


FE«8« 




*I08- ' 


0000* 


1 


IRTY 


1856 


17 


•ISTCK 


FE36* 


I 


«ITA8 


FS16« 




•ITARS 


Ffl«* 


1 


«JMPRO 


155'» 


11 


JMPROA- 


1550 


11 


LANOF 


1856 


17 


Lf.C 


002«* 


1 


LENF 


. 1856 


• 17 


LETY 


1856 


17 


• LINE 


OlbO 




UNtO 


016E 


I 


LINE2 


017« 


1 


LINES 


0160 


1 


LMOTF 


1856 


17 


LNSZ . 


00S4* 


1 


LOSF 


1856 


17 


LORF 


1856 


17 


LXORF 


1856 


17 


«CMF 


1856 


17 


MfMF 


1856 


17 


MEMY 


1856 


17 


KODf 


0O«0« 




• NIC 


006A* 


I 


NKYF 


OCOA 


2 


NLIN 


015A 


I 


NLINO 


0156 




KOTF 


1856 


17 


• NPV 


0004* 


1 . 


NVO 


0012* 


.1 


NVS 


00ia« 




NXtXS 


0200 •• 


•1- 


wrT-T 


L29«. 


•6. •• 


ONY 


1 856 ■: 


17 


fWF • 


•1856 


17 


OUTUl 


1516 


10' 


«PFTX 


OAOE 


1 


PLC 


ooie* 


1- 


■ PLF 


0038« 




PUTS 


161E 


13 


PLYXX 


161? 


13 


POPY 


loOO 


8 


POwF 


1856 


17 


PSTENO 


152« 


10 


PRTY 


163« 


1« 


PUTS 


I7b8 


15 


•RANOS 


FZb(^* 




RANOZ 


ie«o 


17 


ftANY 


1856 


17 


ROOY 


1«56 


17 


»)>SST 


olja 




RNKY 


1<»56 


17 


ROOT 


186« 


18 


RTNY 


130E 


8 


SFSM 


OAFO 




SINF- 


17CA 


16 


>SUN 


0026* 


1 


SL7 


OOOE* 


1- 


SORF 


1856 


17 


«SO«I 


eoo.a* 


-1. 


S»HF 


1856- 


• IT 


*SSP 


FF76« 


1 


3Ut5F 


oooc • 




SYSP 


ni'c 


7 


TEMP 


•FF<?a« 


1 


«TEMP2 


FFe6« 


I 


.TEhPti 


FFSM* 




eTEMPt, 


FF9A« 


1 


•TICF 


1856 


17 


TTMY 


1«56 


17 


TRPY 


1856 


17 


TYO 


OOlft* 


I 


TYPO 


OPbE 


2 


• TYPU 


0F6C 


2 


TYPa 


0S80 


2 


«TYPiE 


0P7E 


2 


TYPC 


OP. 7 8 


2 


• UtCNT 


153C 


10 


tiPT 


0008« 




•UMSK 


0003« 


1 


UNIT 


OOIA. 


I 


UNI Y 


1856 


17 


VDT 


000A« 




VNT 


001ft* 


1 


»«PR1 


FEfiA* 


1 


•hP«103 


FF90« 


1 


• ♦»PR10'! 


FF92« 


1 


BrtPRlOfi 


FF^A* 


1 


nPR2 


FFDC« 


1 















•t^ WARNINGS 
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FIGUHE E-2. LINK EDITOR LIST FILE OUTPUT (SHEET 4 OF 41 



E-»8 



The configuration process is now complete. When the Target POI^ER 
BASIC Interpreter/ Application is executed in the TM990 Urget system, 
the output pictured below will result. 



HOW MANY CHARACTERS PER LINE ON YOUR 7ERMINAL7&0 
MAGNITUDE ? 3S PERIOD ? i? # STEPS ? 3S 
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E.2 COI^IGURATION OF NUMERIC ENTRI EXAMPLE PROGRAM 

This exaaple progrsmwill accept ntmeric user responses and display 
their square and square root. This program will also be developed and 
thoroughly tested on the Host POWER BASIC Interpreter before 
continuing to the configuration process presented below. The listing 
of the program is: * 

LIST 

5 REM TEST1 
7 BAUD 0,4 
10 DIM A(4) 

20 $A(0)s"THE NUMBER IS" 
30 INPUT "INPUT NUMBER", N 
•' 40 IF N-INP(NX>0 THEN PRINT $A(0)jN:: GOTO 60 
50 GOSUB 100 ! EVEN OR ODD INTEGER 
r^ 60 PRINT ", ITS SQUARE IS";N«N;", AND ITS SQUARE ROOT IS"* 

70 IF N<0 THEN PRINT " UNDEFINED.":.: GOTO 30 
80 PRINT SQR(N);»." 
90 GOTO 30 

100 IF INP(N/2)*2=N THEN PRINT $A(0);" EVEN"::: RETURN 
110 PRINT $A(0);" ODD"; 
120 RETURN 

The user must then save the program onto a diskette file as follows: 

BDEFS "DSC2: TEST 1 /SRC" . 
SAVE "DSC2:TEST1/SRC" 

The diskette files to receive the Configurator outputs must also be 
defined as follows: 

BDEFS «DSC2:TEST1/LNK" 
r BDEFS "DSC2:TEST1/0BJ" 

The user will then terminate the Host POWER BASIC Interpreter (via the 
BIE statement) and return to the TX990 Operating System. 

Next the Configurator will be executed. For details on the loading 
and execution of the Configurator, refer to Section 2. The user will 
respond to the prompts of the Configurator as follows: 

POWER BASIC CONFIGURATOR REV C.I. 4 

APPLICATION SOURCES DSC2:TEST1 /SRC 

LINK CONTROLS DSC2:TEST1/LNK 

OBJECT FILES DSC2: TEST 1 /OBJ 

LIST FILES LP . - • ■ 



E-IO 






The Configurator will begin executing on the application program and 
produce the link control file, object file, and the listing output. 
When the configuration process is complete, the APPLICATION SOUHCEs 
prompt will again be displayed. The user will respond with the ESCAPE 
key (RESET on the VDT913 or the unlabeled function key on the VDT911) 
. to terminate Configurator execution. 

The listing output produced by the Configurator is shown in Figure 
E-3. The user should refer to Section 8, paragraph 8.4,3.3 for 
details on the Configurator list file output. 

The Link Editor will then be loaded and executed using the TXDS 
Control Program as follows: 

TXDS 936215 »A 293/78 11:45 

• PROGRAM: DSC : TXSLNK/SYS 

INPUT: DSC2: TEST 1 /OBJ 

OUTPUT: DSC2:TEST1/SYS,LP 

OPTIONS: Ml 5000 

The Link Editor will be called into execution, and will produce the 
final linked Target POWER BASIC Interpreter/Application. 

The listing output produced by the Link Editor is shown in Figure E-4. 

The user may then test the final object module (DSC2: TEST 1 /SYS) by 
using AMPL to verify the operation of the Target POWER BASIC 
Interpreter/Application before performing the final steo of 
programming the object file into EPROM. 

The configuration process is now complete. When the Target POWER 
BASIC Interpreter /Application is executed in the TM990 Target system, 
the output shown below will result. 

'■'Ur NUMBER? 45 

■ .NUMBER 1:5 ODD, ITS SQUARE IS 2025 r AND IfS SQUARE ROOT IS A. 7r)ft-TT,3.-v ^ 
■Vr NUMBER? 87 '* 

1 NUMBER IS ODD, ITS SQUARE IS 7569, AND ITS SQUARE ROOT IS •^..'-r^^-.iyoi 
»UT NUMBER? -2 . -- , . 

i NUMBFR IS EVEN, ITS SQUARE IS 4, AND ITS SQUARE ROOT IS UNDEFINED 
='UT NUMBER? ' . 

1 NUMBER IS EVEN, ITS SQUARE IS 0, AND ITS SQUARE ROOT IS 0. 
='UT NtJMBF.R? 256 

Z NUMBER IS EVEN, ITS SQUARE IS 65536, AND ITS SQUARE ROOT IS lA. 
*UT NUMBER? SOOO 

■ NUMBER IS EVEN, ITS SQUARE IS 64000000, AND ITS SQUARE ROOT IS S9.44-.'7i' 
='UT NUMBER? FF?? 2 *" 

• NUMBER IS EVEr^l, ITS SQUARE IS 4, AND ITS SQUARE ROOT 'IS 1. 414;'ir-V... 
*UT NUMBER? 02H 

: NUMBER IS EVEN, ITS SQUARE IS 4, AND ITS SQUARE ROOT IS 1.4i42136. 
=Ur NUMBER? OFH 

Z NUMBER IS ODD, ITS SQUARE IS 225, AND ITS SQUARE ROOT IS 3 . !-!/29:=!3:^f . 
='UT NUMBER? 15 

■ NUMBER IS ODD, ITS SQUARE IS 225, AND ITS SQUARE ROOT IS :"!. :=i7--'9!-::-:::; 
^-Uf NUMBER? ,5 

I NUMBER IS 0.5, ITS SQUARE IS 0.25,. AND ITS SQUARE ROOT IS 0.70710673, 



POWRR BASIC CONFICJllRATOR REV C.3.4 

APPLICATION S0«JRCE=DSC2s fESTl/SRC 

I. INK C0NTR0LsDSC2s TEST 1 /LNK 

OB. .lEC r F I LE«DSi::2 J TEST 1 / OBJ 

( EDIT FRf<ORS, IF ANY, LISTED HERE > 



'NUMBER OF BYTES OF PSEUDO SOURCE* >Ol25i 
PiiWEK &AS3C CONFIGURATOR REV C.le4 



MODULE SUMMARY 
MODULES USED 



NAME 

BAUDC - 

CVDB 

DIM 

GOSUB 

INPUT 

JMP 

MOVE 

PRINTC 

SOIRF 

POWER BASCC CONFIGURATOR RfeV 0,1.4 

STATEMENTS USED 



PRIMARY 
REF 


SECONDARY 

REF 




«— ._ 


. 1 

1 


8 
2 



6 


1 


1 




7 


' 
6 


. 7 



1 








PRIMARY 


SECOND 


NAME 


REF 




REF 


— —— 








CVBDC 





• 


6 


CVGC 







8 


FUNCC 


2 







IF 


3 • 







IPCOM 







7 


LET 


1 




, 


POLY 







t 

1 


PUTB 


•0 




1 



ySRSfK 



NAME 


# OF REFS 


MODULES 


GOTO • 


3 


GOSUB 


GOSUB 


1 


GOSUB 


(LET) 


1 


LET 


PRINT 


6 


PRINTC 


INPUT 


1 


INPUT 


RETURN 


2 


GOSUB 


BAUD 


1 


BAUDC 


DIM 


1 


DIM 


IF 


3 


IF 



POWER BASIC CONFIGURATOR R'EV C.1.4 

FUNCTIONS USED 
NAME # OF REFS MODULES 



INP ■ 2 FUNCC 

SQR 1 SQRF 



• FIGORE E"3. CONFIGURATOR LIST FILE OUTPUT 
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TXSLNK 2.3.1 78.204 01/00/00 00:01:11 PAGE _ 1 

COMMAND LIST 

NOSTMT 
NOAUTO 

UIIJRARY :C8ASIC/t.n 
TASK CBASIC 

INCLUDE :STAaTr/OflJ 

INCLUDE (SAUOC) 

INCLUDE (CV60C) 

INCLUDE (CVOP) 

INCLUDE (CVGC) 

INCLUDt (DIM) 

INCLUDE (FUNCC) 

INCLUDE (G0SU8) 

INCLUDE (IF) 
INCLUDE. ( I MPUl), 

I-NCLUDr '('iPCriMV 

INCLUDE (JMP) 

INCLUDE (LET) 

INCLUDE (MOVE) 

INCLUDE (POL,Y) 

INCLUDE (PPINTC) 

INCUOE CPUTB) 

•INCLUDE (SQRF)- 

INCLUDE (Z7EN0C) 

INCLUDE 0SC2:TFSTl/0Bs« 
END 

SYMBOL •"'ULTIPLY OEFTw^O ♦i*«w*w*v^»-.^tivi**v«w*g%«rt*y.«w^i*i«v».«i»*;\«»v*'.^'tir<*v%*»ii«i«i*%N*W'«w 
SYM80L s ARS? ^'OnuUES s 7, l<5 

S YM8 OL ^HLT I PL Y DIP I N»6 # .< # w * .tv « * ,Tiir /^ « w * w * 1-. ♦ ,s- ♦ 1% « i^ # r. »%^ ♦tt* i^* ^ ♦ vi » •.% # w*-i ♦^^ ♦ -i # ** ♦!(«» 
SYM^iOL s flAuO ^•OOULES s 2. l« 

Symbol multiply DEFIAEO «A*v<»*i*«*%*t^*.^*A*v\*i^»«*^«**H*.v«^ «A*«%**:^ri*v»*;M«*.^«t>«v.#i«i«t^ 
SYMftOL s CVbO MOOULES = 3/ 1^ 

SYMBOL MULTIPLY OEPI^^£^ *<<*ir»i*'.*i^>t^*i^*»^*v»«V!i*»^'ti**v'-«^*/.'*v^»ir.»«^*.i«*t^*;t'»w*w*/«'»vt«y<*i^ 
SYM80L s ever MgnULES s 3. l^ 

SYMHOJ^ MULTIPLY DEFINED *w««#r4*i%*^*v%»w«tft:'*^*lr«*f.^?**A»>»«W*:%*»*''»^*w*/««'Ai»A«.^'«w*w 
SYMBOL s DIMY »-OOULFS s b, l« 

SY^ROi^ -^ULTIPIY OEFP'ED «w*v^«;'H«^«w*w«v5*vw*v>#r*t**iri*rt*»^*«««rr'«h*9^*^*w'»N*!(«*»**''i*i«» 
SYM60L s r-OSl •-UOULES s 6/ 1^ 

SYMBOL r GOSfll •'OOULES s A, i<3 

SY'^BOL MULTIPLY 0£FI\«ED ♦ w -t .•<#. ^ * r, **»♦»••* y«i# w* h*v%«f%*rt^»«^*v^ ♦•*♦'.•; «.'i*v,*;*r«i!v*,^«vr*/.# 
SYMBOL s CnSY MODULES s 8, 19 

SY^eOL W'JLT IPl.Y OEF t^iED ♦w*w*»s*:^*a ♦^♦^ii* w *.»«»* *r t/i*;, •t*'# a*/.* •v ♦«•?»*«-•«?♦, •'*^«'«»«if. 
SYMMHL s r^OTY WOOULE'^ s ft# 19 • 

SY^*60L MULT I°LY 0£FINfeD ♦•»*w*w«v^*W« •i«A*«%*r>«w«ir.*i; ^w*^ ♦/!♦•* *t%*ni«*i>« •!♦«**•♦ *a««*** 
SYMBOL s IFY MODULES s 9, IQ 

SYMBOL '"^ULT I^L Y ngF If'EO ♦^♦w«\»«^* .*i*a«**« w*v, ^w^r^i^^.t^ -^^r^^r. '»*,*,*4*^-«r;*«i«.^« A*»<r*^. 
SY^HOL s IMPP MODULES s 7, I <5 

FIGDHE E-4.. LINK EDITOR LIST FILE OUTPUT (SHEET 1 OF 4) 
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E-13 



TXSLNK 2o3:. a 78,244 01/00/00 00:02:13 
COMMAND LIST 

. SYMBOL MULTIPLY DEFINED *W*W«W«W*W*W«W*W*W*U-aW*W*W*W«W*W* 
SYMBOL « INPY MODULES « 10, l"?- 

SYMBOL MULTIPLY DEFINED «W*W*W*W*W*W*W*W*W*W«W*W-«W*W«W«W* 
SYMBOL » LETY MODULES « 13, 19 

SYMBOL MULTIPLY DEFINED ♦W*W*W*W*W»W*W*W*W*W*W*W*W*W*W*W-k 
SYMBOL = NKYF MODULES « 2, 19 

SYMBOL MULTIPLY DEFINED *W#W*W»W*W*W»W*W*W«W»W*W*W-rW«W*W« 
SYMBOL « POPY MODULES = S, 19 

» 

^.^ SYMBOL MULTIPLY DEFINED *W*W*W*W»W«W*W*W*W*W*W*W*W«W*W*W« 
SYMBOL « PRTY MODULES « 16, 19 

SYMBOL MULTIPLY, DEFINED «W*W*W*W*W*W*W*W*W*W*W»W-«W*W*W*W* 
SYMBOL s RTNY MODULES » St 19 ' 

SYMBOL MULTIPLY DEFINED *W«W*W»W*W*W*W*W«W*W*W*W-»W*W«W*W« 
SYMBOL « SQRF MODULES « 18, 19 

SYMBOL MULT.TPLY DEFINED *W*W«W*W*W»W»W*W*W*W*W*W*W*W«W«H.» 
SYMBiX. = SYSF MODULES =7, 19 

CONTROL FILE = DSC^: TEST 1/LNK 
n LINKED OUTPUT FILE « DSC2: TEST 1 /SYS 

LIST FILE « LP 
OUTPUT FORMAT = ASCII 
LIBRARIES 

NO ORGANIZATION PATHNAME 
1 SEQUENTIAL sCBASIC/LIB 

• FIGUHE E-4. LINK EDITOR LIST FILE OUTPUT (SHEET 2 OF 4) 
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TXSLNK 



2.3.1 78.2aa 



Ol/OO/QO 00:01:11 



PAGE 



PHASE 0, CBASIC ORIGI^M s 0000 LENGTH s USO 



MODULE 

STAflTC 

eAUOC 

CV80C 

CVOB 

CVGC 

DIM 

FUNCC 

Gosue 

IF 

INPUT 

IPCOM 

J.MP . 

LET 

MOVE 

POLT 

PRINTC 

PUTB 

SQPF 

ZZENOC 

ROOT 



f^O ORIGIN 



1 
2 

3 
a 

6 

7 

8- 

9 

10 

11 

12 

13 

la 

«r 
\b 

17 
16 
19 
20 



0000 

oeo^ 

0C3C 
0F8A 
113C 
ll«A 
.1252 
i2-A9 
13^8 
13C6 
laCC 
1506 
1522. 
1664- 
1 6C4^ 
172C 
1860 
IflAE 
19U 
1928 



LENGTH 

0604 
013fl 
034E 
01B2 
005E 
00B6 
,0056 
OOAO 
0080 
0104 
003A 
OOIC 
0142 
0060 
0066 
0134 
00a£ 
006C 
OOOE 
0128 



TYPE 

iNCLUOt 

INCLUDE,! 

INCLUDED 

INCLUDE,! 

INCLUDE,! 

INCLUDE,! 

INClpUOE#l 

INCLUDE, r 

INCLUDE,! 

INCLUDE/! 

INCLUDE.! 

INCLUDE.! 

INCLUDE,! 

INCLUOE.i.1 

INCLUOE/l 

INCLUDE.! 

INCLUDE. 1 

INCLUDE.! 

INCLUDE.! 

INCLUDE 



DATE 

01/02/79 
Ot/03/79 
01/03/79 
01/03/79 
01/03/79 
01/03/79 
01/03/79 
01/03/70 
01/03/79 
01/03/79 
01/03/79 
01/03/79 
01/03/79 
01/0.3/7.9 
or/03/79 
01/03/79 
01/03/79 
01/03/79 
01/O3/7« 



TIMg 

14:08:03 
09:51:17 
09:52:32 
09:52:5! 
09:53:06 
09:53:32 
..09:54:31 
09:55:08 
09:55:2a 
09:55:39 
09:56:08 
09:56:21 
09.:56:32 
.09:57:27 
09:5r:5'l 
09:58:21 
09:58:02 
10:00:06 
10:01:02 



CREATOR 

SUSLNK 
SDSLNK 
SOSLNK 
.*50SLNK 
SDSLNK 
SDSLNK 
SDSLNK 
■ SDSLNK 
SOSLNK 
SDSLNK 
SOSLNK 
SOSLNK 
SOSLNK ' 
SOSLNK . 
SOSLNK 
SOSLNK 
SOSLNK 
SOSLNK 
SOSLNK 
CONFIG * 



y(SBt\ 



DEFINITIONS 



NAME 

ABsr 

ASRQ 

805 

8AU0 

BMVE 

C4A00 
•CLKAOR 
♦CLKWS 

CR8Y 
*CVBE 
♦CVD820 

CVGCNl 
♦DATX8 
•DLC . 
*0S2 

ELNH 

ERRY 

EVAR2 

EVS02 

EXPF 
•FDD 
•FLOAT 

FNS 

FPAC2 
•FSD 



VALUE NO .NAME 



128C 

003C* 

0965 

0808 

1664 

OlFC 

FE6C* 

FE6A* 

191A 

0E4E 

lOCa 

1 144 

0201 

0020« 

FF8C* 

002E* 

191A 

0582 

0574 

191A 

0482 

0300 

0004* 

FF9E« 

023C 



7 
1 
1 
2 

14 

1 
1 
1 

19 
3 

4 

5 



*AODF . 

ASRl 

820 
*8CRU 

BUS 

C6 

CLKI 

CLLY 

CRFF 

CVBt 

CVOIFI 

CVHO 
•DOM 

OLIM 
*0S3 

ELSF 
♦EUS 

EVERZ 

EVSFR 

♦ FAD 
FFL6 

• FMO 
♦FNS2 

FPAC4 
*FSH0 



VALUE NO 



09da 

003E* 

01-FE 

003A* 

oooci 

096A 
191E 
191A 
191A 

ocao 

OFSE 
FEF2* 

0022* 

OOIE* 

FFC2* 

0030* 

0002* 

05CC 

0714 

0246 

0032* 

0362 

OOOA* 

FFAO* 

022C 



NAME 

ANOF 

ATNF 

53F 

BI.Tr 
*C1 

CCNT 
♦CLKTOl 

COSF 

CRFY 

CVCIO 
*CV012 

CVHDOl 

DEFY 

OS. 
*feflP 
♦ELSY 

EVAL 
*£VFX 
*£VSK8 

FAODI 

FIX 
*FNEG 

FOHY 

FSUBI 



VALUE NO 



191A 

191A 

OlFF 

191A 

0^6 

0028* 

FE72* 

191A 

1«1A 

1164 

0F8A 

FEF3* 

191A 

FE76* 

FEF2* 

191A 

073C 

05Ea 

FEF2* 

051E 

0AB2 

02F6 

191A 

FF9C* 

0532 



NAME 

A3CF 

BO! 

^ASY 

8ITY 

C4 

CXEX 
♦CLKT02 

CRBF 

CVBD 

CVCH 

CVGCN 

CVHD15 

DIMY 
*DS! 
*EFLG 

ENUM 

EVALS2 

*EV0P3A 

*EVSKE 

*FCLR 

♦FLOO 

*FNRM 

FPAC 

.♦FSCL 
*FUN8K 



VALUE NO 



19!A 

0961 

191A 

I^IA 

0962 

0586 

FE7a* 

191A 

0Ca8 

FEEC* 

113C 

FFOl* 

119A 

FE7C* 

002A* 

002C* 

0734 

087E 

FF9i^* 

04a£ 

0234 

0328 

FF9C* 

0546 

16C4 



1 

!<» 

1^ 

1 

1 

1 

19 

3 
1 
5 

I 
6 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
15 



yfl?^^V 
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7 XSLNK 




2.3. 


1 78.244 




01/00/00 OOs 


02:1© 






NAME 


VALUE 


NO . 


NAME 


VALUE 


NQ 


NAME 


VALUE 


NO 


NAME 


RJNFX 


16EE 


15 


*FUZZ 


3B00* 


1 


*gf:tc 


0BF6 


2 


GEICR 


OOSl 


12F2 


© 


♦i30«2 


1306 


© 


GOSBl 


12A6 


8 


*|jOSUN 


GOSY 


12B4 


S 


fJOlY 


12E6 


s 


esc 


0016* 


1 


ess 


*0:SSZ 


0014* 


1 


HFLG 


0034* 




*HOur 


1S22 


16 


IFLI5 


IFY 


1346 


9 


IMKY 


191© 


19 


INFEND 


14E0 


11 


INPF 


INPY 


13C.6^ . 


10 


♦INTFLG 


FE56* 




INTIN 


191C 


19 


*INTSB 


»INTSP 


feSs* 


1 


*INTWP2 


FE48* 




lOB . 


0000* 


1 


IRTY 


*^TCK 


FE36* 


I ' 


♦ ITAB 


FE16* 




*irAB2 


FEl©* 


1 


*.JMFRO 


; . IPROA 


1504 


12 


LANDF 


191© 


19 


LEC 


0024* 


1 


LENF 


LEfY 


1520 


13 


LINE 


0160 




LINEO 


016E 


1 


LINt£2 


LINES 


0160 


1 


LNOTF 


191© 


19 


LNSZ 


0084* 


1 


LOGF 


UORF 


191© 


19 


LXORF 


191© 


19 


MCHF 


191© 


19" 


MEMF- 


MEMY 


191© 


19 


MODE 


0040* 




*NIC 


0064* 


1 


NKYF 


NLIN 


015A 


I 


NLINO 


0156 




NOTF 


1918 


19 


*NRV« 


NVD 


0012* 


1 


NVS 


0014* 




♦NX1 XB 


0200 


1 


• NXTY 


ONY 


191© 


19 


ORF 


191© 


19 


QUTLl 


14CA 


11 


*PFIX 


PLC 


00 XC* 


1 


PLF 


0038* 


i» • 


«PLYX 


1714 


15 


*PLYXX 


POPY 


13:54 


8 


POWF 


1918 


19 


PR TEND 


14D8 


11 


PR! Y 


PI.ITB 


1©5E 


17 


♦RANDS 


FE6S* 




K'ANDZ 


1922 


19 


RANY 


RDDY 


1918 


19 


♦REST 


0134 




RNUJY 


1918 


19 


ROO r 


RTNY 


1312 


© 


SFSN 


OAEE . 




SINF 


1918 


19 


«SLN 


SLT 


OOOE* 


I 


SQRF 


18AC 


13 


SQRI 


0004* 


1 


SRHF 


*SSP 


FF76* 


1 


»SUBF 


09DA 




SYSF 


1250 


7 


TEMP 


*TEMP2 


FF96* 


I 


*TEMP4 


FF9©* 




*rEMP6 


. FF9A* 


1 


ricF 


TIMY 


191© 


19 


TRPY 


191© 


19 


TYO 


0018* 


1 


TYPO 


^r^pii 


0©6A 


2 


TYPB 


0B7E 


2 


*TYPB£ 


0B7C 


2 


TYPC 


*uC:CNT 


14F0 


11 


UFT 


0008* 




*UMSK 


0003* 


1 . 


UNIT 


LINTY 


1913 


19 


VDT 


OOOA* 




*VNT 


0010*. 


1 


WPRl 


*WPR103 


FE90* 


1 


♦WPR104 


FE92* 




♦WFR3 08 


FE9A* 


1 


WPR2 



19 WARNINGS 
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FIGORE E-4. LINK EDITOR LIST FILE OUTPUT (SHEET 4 OF 4) 



E-1, 



SOFTWARE THODBLE REPORT 





SIR NUMBEB 


SUBMITTED EX 


{Tor n use) 

DATE 


COMPANI 


TEL. NO. 


MAILING ADDRESS 




REPORTED TO 


TEL. NO. 




CUSTOMER INFORMATION: 
SOFTWARE/DOCUMENT NAME 


- 


TEXAS INSTRUMENTS PART NO. 
PROBLEM TIPE: (CIRCLE ONEl 
SOFTWARE DOCUMENTATION 


REVISION VERSION 
OTHER (explain) 


PROBLEM SUMMARI: 




• - 
























EQUIPEMNT DESCRIPTION: 
MEMORY SIZE: 
RAM 
EPROM 


MANUFACTURER MODEL 


MICROCOMPUTER BOARD 




EXi'ANSiON MEMORX BOARD (S) 






ADDITIONAL BOARDS Hi SYSTEM 











/""^[Sfiv 



PLEASE ATTACH ALL NECESSARY INFORMATION TO DUPLICATE* 'iHE ABOVE REPORTED 
DISCREPANCE. USE ADDITIONAL PAGES IF NECESSARY. 



MAIL TO: 



TEXAS INSTRUMENTS INCORPORATED 
P.O. BOX 1443, M/S 6407 
HOUSTON, TEXAS 77001 



r"- 



^\ 



MP318 




Texas Instruments 



INCORPORATED 

Semiconductor Group 
Post Office Box 1443 Houston, Texas 77001 



Pointed in U.S.A. 



